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

PredictAsiaX MCP 中文接入指南

发布于 2026-09-05阅读时长：约 8 分钟分类：开发者指南

核心摘要

PredictAsiaX MCP 服务器让 Claude Desktop 与 Claude Code 直接搜索、分析、（配合 API 密钥 + 用户确认）交易 PredictAsiaX 上的事件合约。44 个工具覆盖市场搜索与数据、概率追踪、组合与持仓、下单撤单、费用估算、子账户、做市、结算证据、建构者应用、沙盒示例。配置耗时 5 分钟以内，仅需 1 处 JSON 编辑。17 个公开工具无需认证，另外 27 个涉及用户账户，需建构者项目 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`	公开	按关键词或类别搜索 PredictAsiaX 市场。返回带价格、成交量、状态的分页列表。
`pax.market_get`	公开	获取单个市场的完整详情：标题、问题、价格、成交量、未平仓量、结算规则、模板。
`pax.market_orderbook`	公开	读取市场的盘口买卖挂单阶梯。深度上限为每侧 20 档。
`pax.market_price_history`	公开	市场的概率时间序列历史（LTTB 采样）。范围 1 小时至 90 天。
`pax.probability_movers`	公开	返回指定窗口内 YES 概率变动最大的市场。按 \|delta\| 排序。
`pax.markets_top_volume`	公开	24 小时成交量排行榜。用于发现热门市场。
`pax.category_list`	公开	列出所有市场类别及其数量和 24 小时成交量。
`pax.portfolio_read`	API 密钥	读取用户当前持仓、标记价盈亏（PNL）、未实现盈亏及 USDT 余额。
`pax.portfolio_history`	API 密钥	用户的历史盈亏曲线（已实现 + 未实现），按日采样。
`pax.balance_get`	API 密钥	子账户的 USDT 可用 + 冻结余额。
`pax.positions_list`	API 密钥	列出跨市场的未平仓持仓，含数量 + 入场价 + 当前标记价。
`pax.subaccount_list`	API 密钥	列出用户的所有子账户，含类型、币种和余额。
`pax.place_order`	API 密钥	提交新订单。传输层需带 Idempotency-Key 头。等级上限由服务端强制。
`pax.cancel_order`	API 密钥	撤销一笔未成交或部分成交的订单。
`pax.cancel_all_orders`	API 密钥	批量撤销用户的全部未成交订单 +（可选）指定市场。原子操作。
`pax.orders_open`	API 密钥	列出用户当前未成交订单（状态为 open、partially_filled）。
`pax.orders_history`	API 密钥	用户的历史订单（已成交 + 已撤销 + 已过期），分页。
`pax.fee_estimate`	公开	估算假设订单在 PAX 自适应费率曲线（PAF）下的吃单费：按价格极端程度 8-25 个基点，外加可选的附加合作方费用（0-100 个基点）。
`pax.mm_stipend_estimate`	API 密钥	做市商在某一市场本轮周期的实时 LQF 补贴预测。基于目前所见快照返回 00:15 UTC 的预计发放额。
`pax.mm_stipend_history`	API 密钥	做市商的历史 LQF 补贴发放记录。可选 market_id 过滤，默认上限 30 条。
`pax.liquidity_leaderboard`	公开	滚动窗口内 LQF 补贴收入最高者的公开排行榜。可选 market_id 过滤。
`pax.subaccount_create`	API 密钥	在主账户下创建新子账户。
`pax.subaccount_transfer`	API 密钥	在同一主账户的子账户之间划转 USDT。
`pax.subaccount_close`	API 密钥	关闭（冻结）子账户。若仍有持仓/余额/未成交订单则拒绝。
`pax.composer_templates_list`	公开	列出可用于开设新市场的市场模板（加密货币价格二元、体育、选举等）。
`pax.composer_template_get`	公开	读取单个市场模板，含结算规则 + 示例配置。
`pax.composer_proposal_submit`	API 密钥	从模板提交新市场提案。进入管理员审核队列。
`pax.resolution_evidence`	公开	返回用于结算市场的证据 + 来源。
`pax.mm_quote_post`	API 密钥	向市场发布双边做市报价。TTL 1-3600 秒。需指定做市商身份方可获得返佣。
`pax.mm_quotes_list`	公开	列出市场的活跃做市报价。
`pax.rfq_create`	API 密钥	创建 RFQ（询价）——请做市商为特定规模报价。
`pax.rfq_accept`	API 密钥	接受某一 RFQ 报价——以报价原子成交。
`pax.builder_me`	API 密钥	返回当前建构者资料：等级、应用数、30 天成交量 + 费用收入、已验证状态。
`pax.builder_apps_list`	API 密钥	列出当前建构者资料下注册的应用。
`pax.builder_apikeys_list`	API 密钥	列出某一应用的 API 密钥（仅元数据——绝不返回密文）。
`pax.tier_status`	API 密钥	读取当前建构者等级 + 自动晋级进度（30 天成交量 + 剩余天数 + 滥用标记）。
`pax.fee_ledger_read`	API 密钥	读取归属当前建构者的 fee_ledger 条目——四方拆分份额 + 附加建构者费用。
`pax.webhook_endpoints_list`	API 密钥	列出某一应用下注册的 webhook 端点。
`pax.webhook_create`	API 密钥	注册新的 webhook 端点。返回一次性的 whsec_<hex> 用于签名验证。
`pax.webhook_deliveries`	API 密钥	读取某一端点近期的 webhook 投递尝试（状态、HTTP 码、重试次数）。
`pax.access_request_create`	公开	为建构者通道提交接入申请（无需邮箱——提供 Telegram / Signal / Discord / Matrix / X 私信账号）。
`pax.access_request_status`	公开	按 request_id 查询待处理接入申请的状态。
`pax.sandbox_agent_examples`	公开	针对 PAX 构建 AI Agent 的端到端示例——沙盒密钥、最小流程。
`pax.health`	公开	MCP 服务器健康状态 + 协议版本 + D1 可达性 + 上游延迟。

添加 API 密钥认证

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

{
  "mcpServers": {
    "pax": {
      "type": "sse",
      "url": "https://mcp.predictasiax.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer sk_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: "央行" });

典型问题

重启后工具未出现。 检查 JSON 是否有效（缺少逗号是 #1 原因）。完全重启 Claude Desktop（退出+重新启动，非仅关闭窗口）。
429 限流。 公开工具：每 IP 每分钟 60 次请求；已认证：每 API 密钥每分钟 300 次。尽量批量请求。
401 未授权（写入工具）。 API 密钥错误或过期。到 builders.predictasiax.com 重新生成。
中国大陆用户：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）估算费用、管理子账户、发布做市报价与 RFQ、提交市场提案、管理建构者应用、webhook 与接入申请（需 API 密钥）；（7）运行沙盒 Agent 示例流程用于开发。全部 44 个工具的文档见 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 服务器需要身份验证吗？

44 个工具中有 17 个公开，无需身份验证——覆盖市场数据与参考查询（market_search、market_orderbook、probability_movers、fee_estimate、resolution_evidence、sandbox_agent_examples 等）。另外 27 个涉及特定用户账户——组合、订单、子账户、做市、建构者应用与 webhook——需从 PredictAsiaX 建构者门户（builders.predictasiax.com）签发的 API 密钥。API 密钥通过 Authorization: Bearer sk_live_* 请求头传递。完整认证流程见 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。两者均开源，遵循行业通行的预测市场 SDK 设计模式。源码与示例位于 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。