bitcoin-signals

CoinBucha MCP — 面向 AI Agent 的比特币信号情报

通过 MCP 提供以信号为先的比特币情报。 领先的非价格指标—— 主权国家采用情况、招聘速度、网络算力、ETF 资金流、企业财库—— 每项均以 0–100 的强度、一个方向、一句 why 和一手来源呈现。

仅供参考，不构成财务建议。 所有工具均不会给出买入／卖出／持有建议。

这是 CoinBucha 的公开 MCP 接口。托管服务读取与仪表板展示相同的实时信号数据，因此机器端与用户端始终保持一致。

连接（托管版 — 推荐，无需安装）

该服务是远程服务，使用 Streamable HTTP。将任意 MCP 客户端指向：

https://coinbucha.com/api/mcp

Claude Desktop / Claude Code — 使用该 URL 添加自定义连接器，或在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "coinbucha": {
      "type": "streamable-http",
      "url": "https://coinbucha.com/api/mcp"
    }
  }
}

Cursor / 其他客户端 — 添加 MCP 服务，传输方式设为 streamable-http，并使用上述 URL。

免费层开放使用（按 IP 限流）。使用 API 密钥可获得更高限额，需通过 Authorization: Bearer <key> 请求头传递密钥 — 详见 coinbucha.com。

连接（本地 stdio — 离线／开发）

随附的 server.py 提供相同的工具，并从 coinbucha.com 获取实时公开快照，因此无需本地数据管道。

pip install -r requirements.txt
python3 server.py            # stdio transport
# inspect: uv run mcp dev server.py

{
  "mcpServers": {
    "coinbucha": { "command": "python3", "args": ["server.py"] }
  }
}

工具

工具	返回内容
scan_signals	按排名排列的综合信号流（可按 min_strength、direction、signal_types 筛选）——核心工具
get_hiring_signal	比特币／加密基础设施领域的招聘速度：来自实时 ATS 职位板的开放职位及 30／90 天变化
get_sovereign_reserves	按持有量排名的主权国家比特币持仓（可按 country 或 tier 筛选）
get_treasury_holdings	企业比特币财库持仓：上市公司持有的 BTC 总量及主要持有者
get_etf_flows	比特币现货 ETF 净资金流（最近一天及过去 5／30 天）
get_network_signal	比特币网络算力水平及 30／90 天趋势
get_daily_brew	今日机器可读的信号摘要（CoinBucha Daily Brew）

资源 coinbucha://methodology — 每项信号的计算方式（参见 docs/methodology.md）。 提示词 morning_bitcoin_brief — 用于根据实时信号生成 Daily Brew 的单次调用模板。

每个响应都包含 as_of 时间戳、why 和免责声明。

示例

调用 scan_signals 并传入 { "min_strength": 60, "direction": "tailwind" } → 获取当前最强的结构性利好因素，按排名列出，并附上各自的理由和来源。也可以运行 morning_bitcoin_brief 提示词来生成文字摘要。

方法论与防护措施

信号是领先的非价格指标，以 signal_strength（0–100）、一个 direction 和一个 why 呈现。完整且有版本记录的方法论已公开 — 参见 docs/methodology.md — 因为方法可审计正是其核心所在。

CoinBucha 的公开界面和 MCP 界面均依据 MiCA / FCA / GDPR 进行自我审计。任何界面都不会将信号作为建议呈现。

链接

• 仪表板：https://coinbucha.com
• MCP 端点：https://coinbucha.com/api/mcp
• 发现清单：https://coinbucha.com/.well-known/mcp.json

许可证

MIT — 参见 LICENSE。此仓库提供公开 MCP 接口和方法论；信号采集管道由独立团队维护。