Akka Finance Mcp Server

@akka-finance/mcp-server

AKKA Finance の DEX アグリゲーター向け MCP サーバーです。EVM チェーン全体で、スワップの見積もり、ルート、実行に対応しています。

前提条件

AKKA API キーが必要です。docs.akka.finance/authentication で取得してください。

インストール

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "akka-dex": {
      "command": "npx",
      "args": ["-y", "@akka-finance/mcp-server"],
      "env": {
        "AKKA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add akka-dex -e AKKA_API_KEY=your-api-key -- npx -y @akka-finance/mcp-server

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "akka-dex": {
      "command": "npx",
      "args": ["-y", "@akka-finance/mcp-server"],
      "env": {
        "AKKA_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "akka-dex": {
      "command": "npx",
      "args": ["-y", "@akka-finance/mcp-server"],
      "env": {
        "AKKA_API_KEY": "your-api-key"
      }
    }
  }
}

ツール

ツール	説明
akka_get_quote	25 以上の DEX から最良のスワップ見積もりを取得します
akka_get_swap	署名前のスワップトランザクションを作成します
akka_dex_compare	個々の DEX プールの見積もりを比較します
akka_get_spender	トークン承認用のルーターコントラクトアドレスを取得します
akka_get_approve_tx	ERC-20 承認トランザクションを作成します
akka_check_allowance	現在のトークン使用許容量を確認します
akka_list_tokens	チェーン上で取引可能なトークンを一覧表示します
akka_get_token	アドレスからトークンの詳細を取得します
akka_list_chains	サポート対象のチェーンをすべて一覧表示します

サポート対象のチェーン

チェーン ID	ネットワーク	ネイティブトークン
999	HyperEVM (Hyperliquid)	HYPE
1	Ethereum	ETH
8453	Base	ETH
42161	Arbitrum	ETH
56	BNB Chain	BNB

設定

環境変数または CLI 引数で設定できます。

環境変数	CLI 引数	デフォルト	説明
AKKA_API_BASE	--api-base	https://api.akka.finance	AKKA API のベース URL
AKKA_API_KEY	--api-key	必須	AKKA Finance API の API キー
AKKA_MCP_TRANSPORT	--transport	stdio	トランスポート：stdio または http
AKKA_MCP_PORT	--port	3100	HTTP トランスポート用のポート
AKKA_TIMEOUT	--timeout	15000	リクエストのタイムアウト時間（ミリ秒）

HTTP トランスポート

リモートまたはウェブベースのエージェント向け：

npx @akka-finance/mcp-server --transport=http --port=3100

http://localhost:3100/mcp に Streamable HTTP エンドポイントを公開します。

Base MCP スキルプラグイン

Base 上でのトークンスワップ用に、Base MCP スキルプラグインが skills/akka-swap.md に含まれています。Base のスマートウォレットフローを通じて AKKA を利用したスワップを有効にするには、Base MCP のスキルディレクトリに配置してください。

開発

git clone https://github.com/Akka-Finance/akka-mcp-server.git
cd akka-mcp-server
npm install
npm run dev        # Run with tsx (hot reload)
npm run build      # Compile TypeScript
npm start          # Run compiled output

MCP Inspector でのテスト

npx @modelcontextprotocol/inspector node dist/index.js

仕組み

この MCP サーバーは、AKKA Finance REST API を呼び出す薄いクライアントです。秘密鍵を保持したり、トランザクションを実行したりすることはありません。スワップ／承認用のすべてのツールは、ユーザーが署名して別途ブロードキャストする必要がある、署名前のトランザクションデータを返します。

AI Agent (Claude, Cursor, etc.)
  ↕ MCP Protocol (stdio or HTTP)
AKKA MCP Server (this package)
  ↕ HTTP REST
AKKA Finance API
  ↕ On-chain
25+ DEXes across 7 EVM chains

ライセンス

MIT