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