GDEX Trading

GDEX MCP Server

GDEX（Gemach DAO のマルチチェーントレーディングターミナル）向けの公式 Model Context Protocol サーバーです。AI エージェントに154 個のツールを提供します。うち 145 個は取引の実行とアカウント状態の読み取りを行い、残りの 9 個はドキュメント用です。

• Solana、Sui、および 10 の EVM チェーンでの現物スワップ（buy_token、sell_token、limit_buy、limit_sell）
• トークン化された株式、FX、コモディティを含む Hyperliquid のパーペチュアル取引（open_perp_position、place_perp_order、close_perp_position、get_perp_positions）
• コピートレード、クロスチェーンブリッジ、ポートフォリオ、トークンの検索

サーバーはこのディレクトリ内に実装されています。 npm パッケージ @gemachdao/gdex-mcp-server はこのディレクトリからビルドされ、公式 MCP Registry に io.github.GemachDAO/gdex-mcp-server として登録されています。

ソースの構成

パス	内容
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]：Claude、Cursor、VS Code、Codex、OpenCode の MCP 設定に GDEX のエントリーをマージします（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 を参照してください。