govtrade-mcp

GovTrade MCP 服务

将实时 GovTrade x402 API 封装为 MCP 工具，供任意 Agent 直接调用 — get_congressional_trade_signals、get_congressional_trades 和 get_politician_trading_baseline。

重要提示：谁来付款

此服务会在每次工具调用时，为你的实时 x402 端点付款，使用你在 .env 中提供的私钥对应的钱包——这与今晚早些时候的 agent-payment-test 脚本完全相同。这意味着：

• 运行此 MCP 服务的人需要有资金的钱包（Base 上的 USDC）—— 可以是你（如果你托管此服务并免费提供，以建立声誉），也可以是每个 Agent 操作者（如果他们使用自己的密钥自行运行，这是付费 MCP 工具更常见的生态模式）。
• 底层的 /trades、/signals、/politicians 端点仍会像之前一样获得付款—— 这是一个封装层，而非绕过付款。

目前大多数付费 MCP 工具都要求安装者（Agent 的操作者）提供自己的有资金密钥——此服务正是基于这种模式构建的。广泛发布之前，值得认真考虑这一点。

设置

1. npm install
2. cp .env.example .env，然后填入有资金的钱包私钥
3. 先在本地测试——最快的方法是使用 MCP Inspector：

   npx @modelcontextprotocol/inspector node index.js
   

   这会打开一个浏览器界面，你可以在其中手动调用每个工具并查看真实响应，然后再将其接入任何客户端或注册目录。

在 Claude Desktop 中测试

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "govtrade": {
      "command": "node",
      "args": ["/full/path/to/govtrade-mcp/index.js"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYourKey"
      }
    }
  }
}

重启 Claude Desktop——三个工具应该会显示为可用。

在注册目录中登记

这分为两条独立路径：

1. 官方 MCP Registry（随着时间推移，为其他目录提供数据）

• 需要 server.json 清单，以及一个可通过 GitHub 或域名验证证明所有权的反向 DNS 名称（例如 com.yourdomain/govtrade-mcp）
• 通过 mcp-publisher CLI 发布

2. 人们实际浏览的发现目录

• Smithery：运行 npx @smithery/cli publish <your-repo-url>（或通过其发布平台）——需要先将仓库公开到 GitHub
• mcp.so：通过其表单提交——需要提供服务名称、一句话描述、工具数量（此处为 3）、传输类型（stdio）和 GitHub 仓库 URL
• Glama：仓库公开后会自动抓取；之后认领该条目即可获得已验证状态

在进行上述任何操作之前：先将此服务推送到自己的公开 GitHub 仓库（与 govtrade-x402 分开，或作为其子文件夹——两种方式都可行，但使用独立仓库更便于填写要求提供“GitHub 仓库 URL”的注册表单）。