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 传输

用于远程或基于 Web 的 Agent：

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 MCP 技能目录，即可通过 Base 的智能钱包流程启用由 AKKA 提供支持的兑换。

开发

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