Simmer MCP 设置
一次性引导，将 Simmer MCP 服务器连接到您的代理运行时。只需读取一次，运行一次 — 完成后，不再需要此技能本身。
什么是 Simmer MCP（以及不是什么）
Simmer MCP 为您的代理提供了一个预建的 Simmer 交易技能目录，可以将其作为工具调用 — 像 polymarket_copytrading、polymarket_fast_loop、kalshi_weather_trader 等策略，以及实用工具（技能发现、错误排除）。
此 MCP 的用途：通过您的代理运行预制的 Simmer 交易策略。询问“在干跑模式下运行 polymarket_copytrading 技能的前 3 个市场”，然后 Claude Code（或 Cursor / OpenClaw / 等）调用它。每个技能都作为一个子进程运行，调用 Simmer API。真实交易在配置的场所落地 — 默认为纸质模拟，真实场所需要显式的三重选择（dry_run=false + trading_venue=polymarket|kalshi + SIMMER_MCP_ALLOW_LIVE=true 环境变量在 MCP 服务器上）。
此 MCP 目前不执行的操作（尚未）：将原始交易原语（如 place_order 或 get_briefing）作为独立工具暴露。像“在此 BTC 市场上购买 10 美元的是”或“显示我的当前投资组合”这样的即席操作目前无法通过 MCP 实现 —— 这些仍需要 Python SDK，它直接暴露 client.trade()、client.get_briefing() 等。
原始 MCP 原语是一个跟踪的后续操作。
因此：MCP 和 SDK 是不同的形状，都是合法的。MCP 通过您的代理运行预制策略，具有安全默认值；SDK 构建自定义逻辑，具有完整的原语访问权限。
您将拥有以下内容：
- 通过 npx -y simmer-mcp 运行的 simmer-mcp（可选的全局安装）
- 更新的代理运行时的 MCP 配置，包含一个 simmer 条目
- SIMMER_API_KEY 连接到 MCP 子进程
- 您的代理可见的 ~12 个 simmer 工具：
- 3 个免费的实用工具：list_skills、get_skill_docs、troubleshoot_error
- ~11 个每个技能执行工具（每个捆绑策略一个 —— 默认为纸质模式）
- 4 个 Pro 计划用户的自动研究工具（init_experiment、run_experiment、log_experiment、backtest_experiment）
步骤 1 — 确认您拥有 API 密钥
此技能需要 SIMMER_API_KEY 将其连接到 MCP 配置。有三种情况：
情况 A — 密钥已经在环境中。验证：[[ "$SIMMER_API_KEY" == sk_live_* ]] && echo "OK" || echo "MISSING 或格式错误"
如果“OK”，则跳转到步骤 2。
情况 B — 来自之前仪表板注册的密钥。从 simmer.markets/dashboard →您的代理 → API 密钥选项卡获取它。粘贴它（不要从剪贴板管道 —— 粘贴可能会拾取尾随字符）：
read -s -p 'SIMMER_API_KEY: ' KEY && export SIMMER_API_KEY=$KEY
情况 C — 尚未注册代理。现在注册一个：curl -X POST https://api.simmer.markets/api/sdk/agents/register \ -H "Content-Type: application/json" \ -d '{"name": "my-agent", "description": "此代理的作用"}'
响应包括 api_key 和 claim_url。保存 API 密钥：export SIMMER_API_KEY="sk_live_..."
将 claim_url 发送给人类用户 —— 他们需要访问它，然后才能解锁任何真实货币交易。在那之前，所有交易都保持在模拟纸质场所（这是故意的，而不是错误）。
步骤 2 — 确认 Node.js 和 npm 已安装
simmer-mcp 服务器在 Node.js 上运行。检查：node --version # 需要 v18 或更高
npm --version
如果两个都返回版本 → 跳转到步骤 3。
如果命令未找到，用户需要安装 Node.js。不要通过 curl | sh 自动安装 —— 它会在未经用户批准的情况下修改用户的系统。
相反，显示特定于平台的选项：
平台 推荐安装
macOS 从 nodejs.org（LTS）下载安装程序并双击。或者，如果安装了 Homebrew，则使用 brew install node。
Windows 从 nodejs.org（LTS）下载安装程序并双击。
Linux（Debian/Ubuntu）sudo apt update && sudo apt install nodejs npm
Linux（Fedora/RHEL）sudo dnf install nodejs npm
Node.js 安装程序捆绑了 npm，因此安装 Node.js 会同时获得两个。
安装后，用户需要重新打开其终端，以便 node/npm 登录 PATH，然后重新运行此步骤。
为什么不使用 nvm？nvm 适用于在项目之间切换 Node 版本的开发人员。对于像 simmer-mcp 这样的 CLI 工具的单次全局安装，官方安装程序更简单。
步骤 3 — 安装 simmer-mcp（可选但推荐）
npm install -g simmer-mcp
此步骤是可选的。步骤 4 中的 MCP 配置使用 npx -y simmer-mcp，它在首次启动时即使没有全局安装也会获取包。
全局安装只会使第一次启动稍微快一点（没有获取延迟）。
如果您跳过步骤 3，一切仍然可以正常工作。
如果您安装了它并在 Linux/macOS 上遇到 EACCES 权限错误：不要使用 sudo npm install（这会在以后创建权限纠缠）。
要么按照 npm 的文档修复 npm 的全局目录权限，要么只是跳过全局安装 —— npx -y simmer-mcp 形式在配置中无论如何都可以正常工作。
为什么不检查 --version？simmer-mcp 的二进制文件没有 CLI 标志 —— 每次调用都会启动 stdio MCP 服务器。
验证发生在步骤 6 中，当您的代理...
by