用途
polymarket-news-mcp 是一个 MCP（Model Context Protocol）服务器，用于把现实世界新闻标题与可能受其影响的 Polymarket 预测市场对应起来。很多 MCP 服务器可以查询 Polymarket 价格，而这个服务器关注的是不同的问题：“这件事刚刚发生——关于它的全球信念可以在哪里被读取？” 它面向需要将新闻事件与预测市场关联的 AI 代理，输出实时赔率、深层链接以及可解释的匹配结果。
主要能力
- 新闻与市场匹配：提供工具（如
match_news("Federal Reserve signals rate hike as inflation stays hot")）让 AI 代理输入新闻标题，返回可能被该新闻推动的 Polymarket 市场。 - 可解释匹配：匹配是确定性的、可解释的；每次匹配都会报告触发匹配的具体词项以及置信度分数，便于代理自行判断匹配是否合理。
- 实时赔率与深层链接：提供市场实时赔率和链接。
- 只读默认：默认只读，无需 API 密钥、钱包或托管；市场数据来自 Polymarket 公开的 Gamma API（按流动性排名前约 2,000 个市场，缓存 15 分钟，缓存位于
~/.cache/polymarket-news-mcp/）。 - 可选交易工具（v0.2.0+，需主动启用）：默认只读；仅当安装
[trading]额外依赖并提供自己的签名密钥后，才出现交易工具：trading_status、place_limit_order、place_market_buy、my_open_orders、cancel_order、my_positions。每笔订单受支出上限约束。
匹配机制
匹配基于 IDF 加权的词项重叠，在用户文本与市场问题/事件标题之间计算，并结合：短语（bigram）一致、数字归一化（$120,000 ≡ 120k）、重音折叠、显著性门控（每次匹配必须至少有一个罕见且信息量大的锚点，例如 “openai” 而非 “the”）、每事件只保留一个最佳市场的去重，以及相对截断。匹配分数 ≥15 为高置信度；10–15 为相关实体匹配。
使用方式
要求 Python ≥3.10。使用 uv（无需安装）：
uvx polymarket-news-mcp
Claude Desktop / 任意 MCP 客户端（claude_desktop_config.json）：
{
"mcpServers": {
"polymarket-news": {
"command": "uvx",
"args": ["polymarket-news-mcp"]
}
}
}
或使用经典 pip：pip install polymarket-news-mcp，然后运行命令 polymarket-news-mcp。
首次冷启动后调用需要约 10–15 秒构建索引；后续调用即时完成。
交易（需主动选择，v0.2.0+）
默认此服务器为只读。只有提供自己的签名密钥并安装额外依赖后，交易工具才会出现。
透明性与构建者归因：通过此服务器下的订单会携带 newsbet 构建者代码（0 bps maker/taker——你无需支付额外费用）；Polymarket 的 Builders 计划会将路由的交易量归因到该项目。分叉可通过 POLYMARKET_BUILDER_CODE 覆盖。
安全：你的密钥永远不会离开你的机器，也永远不会被记录。请使用专门的、资金有限的交易钱包。市场 SELL（市价卖出）被有意不提供（上游语义不明确）——请通过限价单卖出。
已知上游问题（2026 年 7 月）：Polymarket 的 py-clob-client-v2 目前无法为新的“deposit wallet”账户签名（#52、#70、#76）。通过 Polymarket 网站使用浏览器钱包创建的账户（签名类型 0/1/2）可以正常工作——请将 POLYMARKET_FUNDER 设置为你的 Polymarket 个人资料地址。
司法管辖区：Polymarket 的 CLOB 会在服务器端拒绝来自受限地区（包括美国）的订单；在禁止地区使用这些工具由你自行承担后果。此处内容不构成财务建议。
适用场景
适合需要把新闻事件与预测市场关联起来的 AI 代理工作流，例如监测新闻、判断哪些预测市场可能受影响、为研究或信息展示提供实时赔率与链接。
限制
- 默认只读；交易功能需主动启用且需自行承担风险。
- 仅提供信息，不构成财务建议。
- Polymarket 的可用性取决于你所在的司法管辖区。
- 已知上游问题：py-clob-client-v2 目前无法为新的“deposit wallet”账户签名。
- 新闻源：CoinDesk、Cointelegraph、Decrypt、The Block、SEC、BBC World & Politics、ESPN（RSS）；欢迎提交 PR 增加更多来源。
