GDEX Trading

GDEX MCP 服务

GDEX 官方的 Model Context Protocol 服务。GDEX 是 Gemach DAO 的多链交易终端。它为 AI Agent 提供 154 个工具：其中 145 个用于执行交易和读取账户状态，另有 9 个文档工具。

• 在 Solana、Sui 和 10 个 EVM 链上进行现货兑换（buy_token、sell_token、limit_buy、limit_sell）
• Hyperliquid 永续合约，包括代币化股票、外汇和大宗商品（open_perp_position、place_perp_order、close_perp_position、get_perp_positions）
• 跟单交易、跨链桥接、投资组合和代币发现

此目录中包含该服务的实现。 npm 包 @gemachdao/gdex-mcp-server 由此构建，并以 io.github.GemachDAO/gdex-mcp-server 为名称列入官方 MCP Registry。

源码布局

路径	内容
src/index.ts	入口点：创建 McpServer、注册所有工具，并通过 stdio 提供服务
src/tools/	按领域划分的工具处理程序：spotTrade、perpTrade、perpRead、limitOrders、copyTrade、hlCopyTrade、bridge、portfolio、managed、directExec、auth、v110、usdc
src/knowledge.ts	文档工具：搜索并读取 GDEX 技能；build:mcp 会将其嵌入 dist/index.js（npm 包和 Docker 镜像不包含 skills/ 目录）
src/workflowGuides.ts	手写的 explain_workflow 指南（由 tests/docs/docExamples.test.ts 根据 SDK 进行类型检查）
src/init.ts	init --client <name> [--force]：将 GDEX 条目合并到 Claude、Cursor、VS Code、Codex、OpenCode 的 MCP 配置中（JSONC 辅助工具位于 src/jsonc.ts，TOML 辅助工具位于 src/tomlLite.ts）
src/sdk.ts	共享的 GDEX SDK 客户端（SDK 位于 ../src）
tests/	Jest 测试
dist/index.js	预构建的单文件打包产物（在仓库根目录运行 npm run build:mcp）

运行

通过 npm：

npx -y @gemachdao/gdex-mcp-server

从源码运行（仓库根目录）：

npm ci
npm run build:mcp
node mcp-server/dist/index.js

使用 Docker 从源码运行（仓库根目录）：

docker build -t gdex-mcp-server .
docker run -i --rm gdex-mcp-server

自动写入客户端配置：

npx @gemachdao/gdex-mcp-server init --client claude   # or cursor, vscode, codex, opencode

现有配置文件会被合并，而非覆盖：其他服务和设置会保留，VS Code 的 JSONC 和 Codex 的 TOML 中的注释会保留，之前的文件会保存为 <file>.bak，并且写入操作是原子的。再次运行不会产生任何变化。如果已存在不同的 gdex-mcp-server 条目，init 会打印当前条目和新条目，并以非零状态码退出；传入 --force 可替换该条目。无法解析的文件不会被修改，init 会以非零状态码退出。

配置

变量	描述	必填
GDEX_API_KEY	GDEX API 密钥；服务启动时会使用该密钥进行身份验证	否
GDEX_API_URL	覆盖 API 基础 URL（默认值：https://trade-api.gemach.io/v1）	否

开发

cd mcp-server
npm ci
npx tsc --noEmit
npm test

许可证

MIT © GemachDAO。参见 LICENSE。