hood-mcp

hood-mcp

适用于 Robinhood Chain（链 ID 4663）的 Model Context Protocol 服务。

一个软件包，包含两个服务：零配置数据服务，任何 MCP 客户端只需一行配置即可添加；以及需明确选择启用的交易服务，供需要执行操作的钱包使用。基于 hoodchain 构建，这是该链的 TypeScript SDK。

文档：https://nirholas.github.io/robinhood-chain-mcp/

原因

目前 Robinhood Chain 还有另外两个 MCP 服务，都只是零星关注、上线仅数日且只读的业余项目。这是产品化版本：提供完整的数据接口（Stock Token、Memecoin、发行项目、链上统计数据），以及带有严格支出上限和确认关卡的受保护交易接口——遵循 three.ws 对其 Agent 工具设定的标准。

60 秒安装

Claude Code

claude mcp add hood-mcp -- npx -y hood-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "hood-mcp": {
      "command": "npx",
      "args": ["-y", "hood-mcp"]
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "hood-mcp": {
      "command": "npx",
      "args": ["-y", "hood-mcp"]
    }
  }
}

任何 stdio MCP 客户端

npx -y hood-mcp

无需 API 密钥、钱包或配置。它会连接到公开的 Robinhood Chain RPC，并立即开始响应工具调用。

两个服务

1. hood-mcp — 数据服务（零配置、只读）

默认使用 stdio；传入 --http（或设置 HOOD_MCP_TRANSPORT=http）即可在 HOOD_MCP_PORT（默认 8730）上使用 Streamable HTTP，提供 POST /mcp 和 GET /health。

工具	功能
get_chain_stats	最新区块、Gas 价格、TVL、网络总量。
list_stock_tokens	包含 95 种代币的 Stock Token 注册表（代码、名称、合约、数据源）。
get_stock_quote	获取指定代码的 Chainlink 价格、Uniswap DEX 价格、溢价/折价及股票价格。
get_portfolio	获取任意地址的倍数修正后 Stock Token 投资组合及 USDG 余额。
get_coin	根据地址获取任意代币（Memecoin 或 Stock Token）的价格/交易量/流动性/持有者信息。
list_trending_coins	获取当前链上的热门资金池。
get_recent_launches	从链上日志扫描近期 NOXA 和 The Odyssey 的发行项目。
watch_launches	实时监控新发行项目，最长 120 秒。
search_token	按代码、名称或地址查找代币。

HOOD_MCP_NETWORK=mainnet   # or testnet — default mainnet
ALCHEMY_KEY=                # optional: private RPC instead of public

2. hood-mcp-trading — 钱包服务（明确选择启用）

独立二进制文件，仅支持 stdio；除非同时设置以下两项，否则拒绝启动：

HOOD_MCP_ENABLE_TRADING=1
ROBINHOOD_CHAIN_PRIVATE_KEY=0x...

{
  "mcpServers": {
    "hood-mcp-trading": {
      "command": "npx",
      "args": ["-y", "hood-mcp-trading"],
      "env": {
        "HOOD_MCP_ENABLE_TRADING": "1",
        "ROBINHOOD_CHAIN_PRIVATE_KEY": "0xYOUR_KEY"
      }
    }
  }
}

工具	功能
get_my_portfolio	查看此钱包的 ETH、USDG 和 Stock Token 持仓。只读。
get_swap_quote	获取 Uniswap 兑换报价，无需签名。只读。
execute_swap	**受保护。**预览 → confirm: true → 广播。设有支出上限。
transfer_usdg	**受保护。**预览 → confirm: true → 广播。设有支出上限。

完整的保护设计请参阅安全模型。摘要：

1. 紧急停止开关 — 未设置 HOOD_MCP_ENABLE_TRADING=1 时，服务进程本身会拒绝启动。
2. 资格门槛 — 买入代币化 Stock Token 需要设置 HOOD_MCP_ACKNOWLEDGE_ELIGIBILITY=1 （美国／加拿大／英国／瑞士人士不得持有 Stock Token — 见下文）。
3. 支出上限 — 每次会改变状态的调用都会以 USD 计价，并在签名前检查是否超过 HOOD_MCP_MAX_SPEND_USDG（单次调用）和 HOOD_MCP_MAX_SESSION_USDG（单个会话， 保存在内存中，重启后重置）。
4. 确认门槛 — 首次调用 execute_swap / transfer_usdg 始终会返回 模拟结果（接收方、金额、代币、最低到账数量），且不会签署任何内容。只有使用 confirm: true 并传入相同参数的第二次调用才会广播。

HOOD_MCP_MAX_SPEND_USDG=25        # default 25 — per single call
HOOD_MCP_MAX_SESSION_USDG=100     # default 100 — cumulative for the process lifetime
HOOD_MCP_ACKNOWLEDGE_ELIGIBILITY=0  # set to 1 ONLY if eligible to hold Stock Tokens

Stock Token 是代币化债务证券（发行方：Robinhood Assets (Jersey) Ltd），不得向美国人士提供、出售或交付（此外还限制加拿大、英国和瑞士人士）。 此限制由法律／前端执行，而非合约层面执行 — 除非操作者明确确认具备资格，否则 execute_swap 会抛出异常。Memecoin 不受限制。

环境变量参考

完整的注释列表请参阅 .env.example。数据服务无需任何配置；交易服务需要设置上述两个紧急停止开关变量。

x402 变现（预留接口，尚未启用）

HTTP 传输层提供了一个文档化接口（src/x402-seam.ts），未来可通过同级目录中的 hood402 USDG-on-Robinhood-Chain x402 通道，为计量收费工具 （深度历史数据、实时数据流）设置付费墙；该通道尚未上线。目前此软件包提供的所有工具均免费。

开发

npm install
npm run build        # tsup → dist/
npm run dev:data      # tsx src/data-server.ts (stdio)
npm run dev:trading   # tsx src/trading-server.ts (stdio, needs env)
npm test              # hermetic: schema + guard tests (real network reads, no wallet funds)
npm run test:live      # live: every data tool against real mainnet 4663 data
npm run test:swap       # live, gated: a REAL testnet swap through execute_swap (needs a
                        # faucet-funded ROBINHOOD_CHAIN_PRIVATE_KEY — see the test file)

依赖 npm 上的 hoodchain；若要基于尚未发布的 SDK 本地检出版本进行开发： npm i ../robinhood-chain-sdk。

注册目录提交（所有者操作）

元数据已准备就绪，但尚未提交 — 发布到注册目录是不可撤回且会关联到提交者身份的操作，应由所有者执行：

• modelcontextprotocol registry — 本仓库中的 server.json 符合 官方架构。 等 hood-mcp 在 npm 上发布后，使用 mcp-publisher 命令行工具提交。
• Smithery — 其当前流程发布的是正在运行的服务 URL 或 .mcpb 包 （smithery mcp publish <url> -n <org/server>），而非静态配置文件。将 HTTP 传输部署到公开位置（hood-mcp --http），然后运行 smithery mcp publish https://your-deployment/mcp -n nirholas/hood-mcp。

许可证

保留所有权利。请参阅 LICENSE。

星标历史

支持本项目

如果 robinhood-chain-mcp 为你节省了时间，请在 GitHub 上为它点星。点星能让其他开发者和 AI Agent 找到值得信赖的仓库，而且只需点击一下。

认识可能会用到它的人吗？在 X 上发布 · 在 Bluesky 上分享 · 在 LinkedIn 上分享 · 提交到 Hacker News · 在 Reddit 上分享

也为 AI Agent 打造

编码 Agent 和大模型工具可以直接读取此仓库：AGENTS.md、llms.txt、llms-full.txt。将 https://github.com/nirholas/robinhood-chain-mcp 提供给 Agent，它就能获得所需的上下文。

同一作者的更多项目

• nirholas 的所有仓库：完整目录，按主题分类
• three.ws：面向 3D AI Agent 的平台，支持 Solana 钱包、技能市场和 x402 支付
• 有问题或想法？提交 issue 或发起讨论

贡献者