← 全部指南
本页内容
  1. 首页
  2. 教程
  3. 扑克 AI agent 如何使用 MCP?
指南 构建产品 · 02/03 AI Agent 12 分钟 中级

扑克 AI agent 如何使用 MCP?

AI agent 只能为受控训练场景或已经结束的牌局使用官方 Pokerai MCP server 获取扑克计算。agent 必须在运行时发现 server 实际暴露的 tool、校验返回数据，并把解释与高影响决策留给人类。

更新于 维护者 Pokerai API

直接答案: 用 Pokerai API key 配置官方 Pokerai MCP server，让 MCP client 发现可用 tool，并且只调用其返回 schema 与已结束手牌或训练任务匹配的 tool。Pokerai API 提供可验证的 cards、equity、strategy 等工具事实；LLM 可以解释或编排，不能替代 solver。每个结果都应作为需人工审核的解释源数据，绝不能成为真实资金牌局中的实时建议。

核心事实

官方 MCP servergithub.com/pokerai-bet/mcp，package 为 @pokerai/mcp
鉴权MCP server 使用 Pokerai API key；将其置于 server 环境中，不要写入 prompt 或浏览器代码。
tool 契约从运行中的官方 server 发现 tool 名称与输入 schema。本指南不假设任何未公开的 tool 名称或 registry listing。
事实依据对 cards、equity、strategy 和其他已文档化事实使用 API-backed 的结构化结果；LLM 文本是解释或编排，不是 solver 输出。
允许用途训练、教学、手牌复盘、学习和研究。
禁止用途禁止在真实资金牌桌上提供实时辅助。

Tool calling 流程

让 agent 循环保持小且可检查。MCP 负责传输 tool 请求；Pokerai API 仍是由 tool 返回 API 数据的来源。

  1. 连接 — 按照官方 README 启动 MCP server，并通过 server 端配置提供 API key。
  2. 发现 — 让 MCP client 获取 server 当前 tool 列表与 schema。不要从本页面、模型记忆或未经验证的 registry 条目推断 tool 名称。
  3. 校验 — 确认请求来自受控训练场景或已结束手牌，且是允许的离线训练、复盘、学习、教学或研究任务；按已发现 schema 规范化输入的扑克数据。
  4. 调用 — 以最少必填参数调用一个已发现的 tool，并在应用审计记录中保留原始结构化结果与请求元数据。
  5. 审核 — 在把解释作为高影响教学或产品输出呈现之前，要求人类审核 agent 的解释、不确定性表达和对混合频率的使用。

最小可验证 agent 循环

这是协议层伪代码，不是声称存在的 tool 名称。它之所以可验证，是因为 agent 会先读取运行中 server 实际返回的 tool 列表和 schema，再发起调用。

tools = mcp.list_tools()
selected = choose_tool(tools, task="offline preflop study")
assert selected.name in {tool.name for tool in tools}
assert selected.schema validates request

result = mcp.call_tool(
  name=selected.name,
  arguments=request
)

human_review(result.structured_content)
write_study_note(result.structured_content)

具体请求与响应结构应同时以已发现的 tool schema 和官方 OpenAPI snapshot 为准。若 server 未暴露合适的 tool，不要替换为猜测的 HTTP 调用，也不要编造 tool 结果。

人工审核与 no-RTA 边界

语言模型可能错误归纳数据或夸大确定性。学习笔记、教学材料和高影响产品输出都应经过人工审核；混合频率应展示为分布，而不是一个推荐行动。Pokerai API 禁止用于真实资金牌桌上的实时辅助。不要将 agent 接入实时手牌流、自动化行动，或把其输出呈现为牌局进行中应采取的决策。

数据边界

  • 仅发送所选学习任务需要的扑克输入。不要在 prompt 或 tool 参数中包含 API key、账户资料和无关个人数据。
  • Pokerai API 请求是无状态的；不要把手牌内容变成营销归因数据，也不要将其保留超过应用复盘工作流所需的时间。
  • 将 API key 与原始 tool 响应保存在受信任的 server 端系统中。agent trace、支持工单和共享示例应删除 secret 与用户标识。
  • 以已记录的 API 契约作为输入和响应语义的权威；agent 的文字只是解释，不能替代源数据。

官方实现链接