Akka Finance

io.github.Akka-Finance由 GitHub 帳號 Akka-Finance 發布v1.0.2更新於 Oct 24, 2026

MCP server for AKKA Finance DEX aggregator — swap quotes, routes, and execution

發布方自己的服務：Finance Foundation

已驗證STDIO僅桌面金融開發者工具

服務詳細資訊

識別碼: io.github.Akka-Finance/mcp-server
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 Akka-Finance。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Akka-Finance%2Fmcp-server.svg)](https://sourceweft.com/mcp/io.github.Akka-Finance%2Fmcp-server?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

面向 AKKA Finance DEX 聚合器的本機 MCP 伺服器，讓助理取得兌換報價、比較 DEX 池，並建構未簽署的兌換與授權資料。

可以做什麼: 取得跨多個 DEX 的最佳兌換報價，並比較各 DEX 池的報價，同時列出支援的鏈與可交易代幣，依地址查詢代幣詳情。建構未簽署的兌換交易與 ERC-20 授權交易。查詢路由合約地址並檢查目前代幣授權額度。它是呼叫 AKKA Finance REST API 的輕量用戶端，不持有私鑰，也不執行交易。
適用情境: 適合需要助理協助研究 EVM 鏈上的兌換路徑與價格，或準備未簽署的兌換與授權交易，交由使用者在自己的錢包中簽署並廣播的情境。
執行需求: 透過 npx 在本機執行，需要 Node.js。需要 AKKA API 金鑰，透過 AKKA_API_KEY 環境變數或 --api-key 參數提供。選用設定包括 AKKA_API_BASE、AKKA_MCP_TRANSPORT、AKKA_MCP_PORT 與 AKKA_TIMEOUT。需要能存取 AKKA Finance API 的網路。

安裝前請注意

需要 AKKA API 金鑰，會保存在用戶端設定中。它只回傳未簽署交易資料，使用者須自行審核、簽署並廣播交易；兌換或授權資料出錯可能造成資金損失。請求與查詢內容會傳送到 AKKA Finance API。

安裝

在 SourceWeft 中

開啟儀表板中的 Akka Finance，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

README

@akka-finance/mcp-server

MCP server for the AKKA Finance DEX aggregator — swap quotes, routes, and execution across EVM chains.

[npm version] [License: MIT]

Prerequisites

An AKKA API key is required. Get one at docs.akka.finance/authentication.

Install

Claude Desktop

Add to claude_desktop_config.json:

json

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

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

Claude Code

Cursor

Add to .cursor/mcp.json:

json

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

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

VS Code

Add to .vscode/mcp.json:

json

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

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

Tools

Tool	Description
`akka_get_quote`	Get the best swap quote across 25+ DEXes
`akka_get_swap`	Build an unsigned swap transaction
`akka_dex_compare`	Compare quotes across individual DEX pools
`akka_get_spender`	Get the router contract address for token approval
`akka_get_approve_tx`	Build an ERC-20 approve transaction
`akka_check_allowance`	Check current token spending allowance
`akka_list_tokens`	List tradeable tokens on a chain
`akka_get_token`	Get token details by address
`akka_list_chains`	List all supported chains

Supported Chains

Configuration

Configuration via environment variables or CLI arguments:

Env Variable	CLI Arg	Default	Description
`AKKA_API_BASE`	`--api-base`	`https://api.akka.finance`	AKKA API base URL
`AKKA_API_KEY`	`--api-key`	required	API key for AKKA Finance API
`AKKA_MCP_TRANSPORT`	`--transport`	`stdio`	Transport: `stdio` or `http`
`AKKA_MCP_PORT`	`--port`	`3100`	Port for HTTP transport
`AKKA_TIMEOUT`	`--timeout`	`15000`	Request timeout in ms

HTTP Transport

For remote/web-based agents:

Exposes a Streamable HTTP endpoint at http://localhost:3100/mcp.

Base MCP Skill Plugin

A Base MCP skill plugin for token swaps on Base is included at skills/akka-swap.md. Drop it into your Base MCP skills directory to enable AKKA-powered swaps through Base's smart wallet flow.

Development

bash

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

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

Testing with MCP Inspector

How It Works

This MCP server is a thin client that calls the AKKA Finance REST API. It does not hold private keys or execute transactions. All swap/approve tools return unsigned transaction data that the user must sign and broadcast separately.

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

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