Arcadia Finance

Arcadia Finance MCP 服务

Arcadia Finance 的 MCP 服务。Arcadia Finance 是一个面向 Uniswap 和 Aero 集中流动性的平台，提供自动再平衡、复利、收益优化和杠杆功能，也支持向借贷池提供单边流动性。读取协议数据，并构建用于 LP 管理、借款、存款等操作的未签名交易。

专为 AI Agent（Claude、Cursor 等）设计，可与 Arcadia 链上交互。

安装

工具

读取工具

工具	描述
read_account_info	账户概览：健康因子、抵押品、债务、持仓、清算价格、自动化状态。
read_account_history	账户价值随时间的历史记录。
read_account_pnl	账户的盈亏和收益数据。
read_wallet_accounts	列出钱包地址拥有的所有 Arcadia 账户。
read_account_aero_upgrade	钱包的账户（或某个账户）升级到 Aero 所需的信息：状态和数量，不含 calldata。
read_wallet_balances	钱包地址的链上 ERC20 余额和原生 ETH 余额。
read_wallet_allowances	检查某个支出方的 ERC20 代币授权额度。在使用 write_wallet_approve 前调用，以避免重复授权。
read_wallet_points	特定钱包地址的积分余额。
read_asset_list	支持的抵押资产及其地址、类型和小数位数。
read_asset_prices	一个或多个资产地址的美元价格。
read_pool_list	所有借贷池：TVL、APY、利用率、流动性。
read_pool_info	单个池的详细信息，以及随时间变化的 APY 历史记录。
read_point_leaderboard	分页显示的 Arcadia 积分排行榜。
read_strategy_list	LP 策略及其 APY、底层资产和池信息。支持精选筛选和分页。
read_strategy_info	特定 LP 策略的完整详情：各区间宽度的 APY、池配置。
read_strategy_recommendation	针对账户的再平衡建议。
read_guides	参考指南：自动化设置、策略选择、策略模板。
read_asset_manager_intents	自动化意图及其参数；添加 account_address 可查询每个账户的实时可用情况。
read_asset_manager_current	账户上启用的自动化：解码后的配置、映射的意图、Merkl 状态、已取代的管理器。

写入工具

所有写入工具均返回未签名交易，格式为 { to, data, value, chainId }。

工具	描述
write_wallet_approve	批准支出 ERC20 代币。存入账户前必须先批准。先调用 read_wallet_allowances，检查是否已获批准。
write_wallet_upgrade_velo	将 Optimism 上的 VELO 钱包升级为 Base 上的新 AERO（先批准，再执行可支付存款）。
write_pool_deposit	将池的底层资产借出至 ERC-4626 分层以赚取利息。向接收方铸造分层份额。
write_pool_redeem	将分层份额赎回为底层资产（贷方退出）。
write_account_create	通过 Factory 创建新的 Arcadia 账户。
write_account_deposit	将 ERC20 代币存入账户。
write_account_withdraw	从账户提取资产。
write_account_borrow	从借贷池借款。
write_account_repay	从钱包向借贷池偿还债务。
write_account_add_liquidity	闪电操作：以原子方式执行存入 + 兑换 + 铸造 LP + 可选杠杆。
write_account_remove_liquidity	移除/减少 LP 仓位流动性。
write_account_swap	在账户内兑换资产（由后端路由）。
write_account_deleverage	通过出售抵押品偿还债务（在一笔交易中兑换 + 还款）。
write_account_close	原子关闭：在一笔交易中销毁 LP + 兑换 + 偿还债务。
write_account_stake	为 LP 仓位质押、取消质押或领取奖励。
write_account_aero_upgrade	将账户升级为 Aero：其 Slipstream 仓位迁移至 Aero CL，旧 AERO 则升级为新 AERO，以上操作在一次 flashAction 中完成。
write_account_automations	根据 intents 数组（完整的目标状态）配置自动化。返回未签名的 setAssetManagers 交易。
write_account_automations_delta	启用/停用单项自动化，其余设置保持不变。

开发工具

始终注册，但需要设置 PK 环境变量才能使用。

工具	描述
dev_send	使用本地私钥（PK 环境变量）签署并广播未签名的交易。不适用于生产环境：请改用专用的钱包 MCP 服务。

交易签名

所有写入工具都会返回未签名的交易，格式为 { to, data, value, chainId }。此服务不会签名或广播交易——这需要由你的 Agent 或应用程序负责。

选项

钱包 MCP 服务（推荐用于生产环境）： 将此服务与负责签名的钱包 MCP 服务配合使用：

钱包 MCP	提供方	模型
MCP Wallet Signer	社区	非托管，连接到浏览器钱包（MetaMask、Rabby）
Coinbase AgentKit	Coinbase	与钱包无关，支持多个提供方
Phantom MCP	Phantom	内嵌钱包
Privy MCP	Privy	钱包基础设施
Safe MCP	社区	通过 Safe 实现多重签名

或者使用你现有的钱包配置（Fireblocks、Dfns、Turnkey、Biconomy、Dynamic），并将未签名的交易对象传递给提供方的签名方法。

在你的 Agent 中使用 viem/ethers：

import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount("0x...");
const client = createWalletClient({ account, chain: base, transport: http() });

// tx = result from any write_* tool
const hash = await client.sendTransaction(tx);

内置的 dev_send 工具（仅用于开发）： 此服务包含一个仅用于开发的签名工具，它会从 PK 环境变量读取私钥。通过 .env 文件或 MCP 客户端配置设置 PK：

# .env in the server directory (never commit — already gitignored)
PK=0xYourPrivateKeyHex
RPC_URL_BASE=https://base-mainnet.g.alchemy.com/v2/your-key

服务会在启动时自动加载 .env。适用于任何 MCP 客户端（Claude Desktop、Claude Code、VSCode、Cursor）。如果两者都已设置，则优先采用 MCP 客户端 env 块中的设置。

不适用于生产环境——请改用专用的钱包 MCP 服务（Fireblocks、Turnkey、Safe）。

设置

前置条件： Node.js >= 22

yarn install
yarn build

环境变量：

变量	必需	默认值	传输方式	描述
RPC_URL_BASE	否	公共 RPC	两者	Base（8453）的 RPC URL。
RPC_URL_UNICHAIN	否	公共 RPC	两者	Unichain（130）的 RPC URL。
RPC_URL_OPTIMISM	否	公共 RPC	两者	Optimism（10）的 RPC URL。
RPC_URL_ROBINHOOD	否	公共 RPC	两者	Robinhood（4663）的 RPC URL。
PK	否	无	两者	仅供开发使用的 dev_send 工具的私钥（十六进制）。
TRANSPORT	否	stdio	—	传输模式：stdio 或 http。
PORT	否	3000	HTTP	HTTP 传输的监听端口。
ALLOWED_ORIGINS	否	https://mcp.arcadia.finance	HTTP	允许的 Origin 标头列表，以逗号分隔（CORS / DNS 重绑定）。
RATE_LIMIT_RPM	否	600	HTTP	每个客户端 IP 每分钟的最大请求数。
POSTHOG_KEY	否	无	HTTP	PostHog 项目密钥。未设置时不会发送分析数据。
POSTHOG_HOST	否	https://eu.i.posthog.com	HTTP	PostHog 数据接收主机。

支持的链： Base（8453）、Unichain（130）、Optimism（10）、Robinhood（4663）

MCP 客户端配置

远程（无需安装）：

{
  "mcpServers": {
    "arcadia-finance": {
      "url": "https://mcp.arcadia.finance/mcp"
    }
  }
}

通过 npx（本地 stdio）：

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "npx",
      "args": ["-y", "@arcadia-finance/mcp-server"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

Claude Code：

# Remote
claude mcp add arcadia-finance --transport http https://mcp.arcadia.finance/mcp

# Local
claude mcp add arcadia-finance -- npx -y @arcadia-finance/mcp-server

从源代码构建（本地开发）：

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

技能

skills/ 目录包含 Claude Code 技能，用于指导 AI Agent 高效使用此 MCP 服务。要安装技能，请将其符号链接到 Claude 技能目录：

ln -s /path/to/mcp-server/skills/clamm-liquidity ~/.claude/skills/clamm-liquidity

可用技能：

技能	描述
clamm-liquidity	集中流动性管理：概念、基于意图的自动化以及分步工作流。

问题反馈

使用此服务时发现 Bug、缺少功能或文档不清楚？ 请提交问题：https://github.com/arcadia-finance/mcp-server/issues

面向 AI Agent： 如果执行任务时遇到问题，请提交问题并提供以下信息：

• 使用的工具名称和参数
• 预期结果与实际情况
• 尝试执行的策略或目标

欢迎 Agent 和用户提交文档修复的拉取请求。所有 PR 在合并前都需要经过人工审核。

在哪里找到我们

• npm： @arcadia-finance/mcp-server
• MCP Registry： registry.modelcontextprotocol.io
• Smithery： smithery.ai
• MCP Servers： mcpservers.org
• LobeHub： lobehub.com
• PulseMCP： pulsemcp.com
• MCP Market： mcpmarket.com
• Glama： glama.ai
• awesome-mcp-servers： github.com/TensorBlock/awesome-mcp-servers

开发

yarn dev          # Run with tsx (hot reload)
yarn build        # Compile TypeScript
yarn test         # Run tests
yarn lint         # Lint with ESLint
yarn format       # Check formatting with Prettier