PredictAsiaX
首页 · 知识库 · MCP 中文接入

PredictAsiaX MCP 中文接入指南

发布于 2026-09-05阅读时长：约 8 分钟分类：开发者指南
核心摘要
PredictAsiaX MCP 服务器让 Claude Desktop 与 Claude Code 直接搜索、分析、（配合 API 密钥 + 用户确认）交易 PredictAsiaX 上的事件合约。7 个工具覆盖市场搜索、概率追踪、组合读取、下单撤单、结算证据、沙盒示例。配置耗时 5 分钟以内，仅需 1 处 JSON 编辑。只读工具公开，写入工具需建构者项目 API 密钥（HMAC 签名）。

5 分钟快速接入

接入 Claude Desktop 到 PredictAsiaX 的最快路径：

1. 编辑 Claude Desktop 配置文件
// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json // Windows: %APPDATA%\Claude\claude_desktop_config.json { "mcpServers": { "pax": { "type": "sse", "url": "https://mcp.predictasiax.com/mcp/sse" } } }
2. 重启 Claude Desktop

重启后 5 秒内 pax 工具会出现在工具抽屉中。

3. 试用

向 Claude 提问：「显示过去 24 小时概率变动最大的 5 个预测市场」。Claude 会调用 pax.probability_movers 并渲染结果。

可用工具清单

工具认证说明
pax.market_search公开按关键词、类别、催化剂、日期范围搜索市场。
pax.probability_movers公开指定时间窗口内概率变动最大的市场。
pax.portfolio_readAPI 密钥读取用户的持仓、成交订单、未实现盈亏。
pax.place_orderAPI 密钥下单（Claude 中会要求用户明确确认）。
pax.cancel_orderAPI 密钥按订单 ID 撤单。
pax.resolution_evidence公开获取已结算市场的结构化结算证据。
pax.sandbox_agent_examples公开MCP 预测市场 Agent 的可运行示例流程。

添加 API 密钥认证

写入工具（portfolio_read、place_order、cancel_order）需要建构者门户（builders.predictasiax.com）签发的 API 密钥。取得密钥后添加到 MCP 配置：

{ "mcpServers": { "pax": { "type": "sse", "url": "https://mcp.predictasiax.com/mcp/sse", "headers": { "X-Api-Key": "pax_live_xxxxxxxxxxxxxxxxxxxx" } } } }

API 密钥在服务器端 HMAC 签名验证。完整认证详情见 docs.predictasiax.com/auth。

Claude Code（CLI）中使用

Claude Code 支持相同的配置格式。放置于 ~/.config/claude/mcp-config.json 或通过 --mcp-config 参数传入。工具在交互式与非交互式（-p）会话中均可用。

替代方案：直接使用 SDK

若不使用 MCP，官方 SDK 封装了 REST + WebSocket API：

# Python pip install predictasiax from predictasiax import Client client = Client(api_key="pax_live_...") markets = client.markets.search(keyword="选举") # TypeScript npm install @predictasiax/sdk import { PaxClient } from "@predictasiax/sdk"; const client = new PaxClient({ apiKey: "pax_live_..." }); const markets = await client.markets.search({ keyword: "央行" });

典型问题

  1. 重启后工具未出现。 检查 JSON 是否有效（缺少逗号是 #1 原因）。完全重启 Claude Desktop（退出+重新启动，非仅关闭窗口）。
  2. 429 限流。 公开工具：每 IP 每分钟 60 次请求；已认证：每 API 密钥每分钟 300 次。尽量批量请求。
  3. 401 未授权（写入工具）。 API 密钥错误或过期。到 builders.predictasiax.com 重新生成。
  4. 中国大陆用户：mcp.predictasiax.com 目前未在中国大陆遭受主动阻断（截至 2026-09），但延迟可能较高。用户须自行核验合规性——中国大陆监管框架禁止参与境外加密币计价的博彩合约交易，MCP 只读工具的教育/研究性使用与写入工具的合规性判断不同。

MCP 生态注册

PredictAsiaX MCP 服务器已在 Anthropic 官方 MCP 注册表（registry.modelcontextprotocol.io）注册，包名 com.predictasiax/mcp，当前版本 v2.0.0，DNS 认证。Kimi、豆包、DeepSeek 等 MCP 兼容客户端可自动发现并连接。

关于 PredictAsiaX：PredictAsiaX 是一家总部位于开曼群岛、专注亚洲市场的事件合约交易平台，支持 14 种语言，以 USDT 结算。开发者资源：Python SDK、TypeScript SDK、REST + WebSocket + MCP。参考条目：Wikidata Q141266910。

常见问题

什么是 MCP（模型上下文协议）？

模型上下文协议（Model Context Protocol, MCP）是 Anthropic 于 2024 年 11 月发布的开放标准，允许 AI 助手（Claude Desktop、Claude Code、以及任何 MCP 兼容客户端）连接外部数据源与工具。MCP 服务器通过 stdio 或 HTTP 传输暴露工具（tools）、资源（resources）和提示（prompts）。配置完成后，AI 可在对话中直接调用服务器的工具。

Claude 通过 PredictAsiaX MCP 服务器能做什么？

连接后 Claude 可以：（1）按关键词、类别或催化剂搜索实时预测市场；（2）获取指定时间窗口的顶部概率变动；（3）读取用户的组合头寸（需 API 密钥）；（4）下单与撤单（需 API 密钥 + 用户明确确认）；（5）查询已结算市场的结算证据；（6）运行沙盒 Agent 示例流程用于开发。全部 7 个工具的文档见 mcp.predictasiax.com/mcp/manifest.json。

如何在 Claude Desktop 中添加 PredictAsiaX MCP？

在 Claude Desktop 配置文件（macOS 路径 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 路径 %APPDATA%\\Claude\\claude_desktop_config.json）中添加 mcpServers 对象，包含 pax 条目指向 https://mcp.predictasiax.com/mcp/sse（SSE 传输），或使用 HTTP 端点 /mcp/call（无状态调用）。重启 Claude Desktop 后 pax 工具会出现在工具列表中。

MCP 服务器需要身份验证吗？

只读工具（market_search、probability_movers、resolution_evidence、sandbox_agent_examples）公开，无需身份验证。写入工具（portfolio_read、place_order、cancel_order）需从 PredictAsiaX 建构者门户（builders.predictasiax.com）签发的 API 密钥。API 密钥通过 X-Api-Key 请求头传递，请求时进行 HMAC 签名。完整认证流程见 docs.predictasiax.com/auth。

可以在 Claude Code 中使用 MCP 服务器吗？

可以。Claude Code（CLI）通过 ~/.config/claude/mcp-config.json（或 CLI 的 --mcp-config 参数）支持相同的 claude_desktop_config.json 格式。配置完成后，MCP 工具在 Claude Code 交互式和非交互式会话中通过 Skill 与 Bash 工具包装可用。

直接 API 集成应使用哪个 SDK？

PredictAsiaX 提供官方 Python 和 TypeScript SDK，封装了 REST + WebSocket API 并内置 HMAC 签名。Python：pip install predictasiax；TypeScript：npm install @predictasiax/sdk。两者均开源且对 Polymarket 兼容（便于从 Polymarket API 迁移的开发者）。源码与示例位于 github.com/predictasiax（当前正在申诉账号恢复）。

MCP 服务器与 REST API 有什么区别？

REST API（docs.predictasiax.com/api）是面向任何客户端的通用 HTTP 接口。MCP 服务器是 REST API 之上的薄适配层，针对 AI Agent 优化——将相同操作暴露为 MCP 工具，附带 AI 模型可推理的描述与 JSON schema，自动处理身份验证、限流、幂等性头。AI 驱动的工作流用 MCP；传统后端集成用 REST。

MCP 服务器有限流吗？

有。公开工具：每 IP 每分钟 60 次请求。已认证工具：每 API 密钥每分钟 300 次请求，建构者项目参与者可获得更高档位。限流命中时响应返回 429 与 Retry-After 头。完整限流策略见 docs.predictasiax.com/security。

相关阅读

事件合约Polymarket 亚洲访问建构者项目开发者文档MCP Manifest