import { setConfig } from '@backtest-kit/mcp';
setConfig({
  CC_MCP_HOST: '127.0.0.1',
  CC_MCP_PORT: 60051,
  CC_MCP_NAME: 'my-mcp',
});

转至的值 setConfig() 永远优于地狱之地.

当软件包运行时 stdio MCP 服务器 (单位:千美元)npx @backtest-kit/mcp,则 backtest-kit-mcp 命令,或 node build/index.mjs而不是env vars:

npx -y @backtest-kit/mcp@latest --host 127.0.0.1 --port 60051

{
  "mcpServers": {
    "trading-signals": {
      "command": "npx",
      "args": ["@backtest-kit/mcp@latest", "--host", "127.0.0.1", "--port", "60051"]
    }
  }
}

或者说

npx -y @backtest-kit/mcp@latest --sse 8081

claude mcp add --transport sse trading-signals http://localhost:8081/sse

主机和端口的解析命令 : CLI 论点 setConfig() 缺省数 (单位:千美元)127.0.0.1:60051) (中文(简体) ).

适用 CLI 参数 仅在二进制模式下 - 入口警卫(helpers/getEntry.ts)确保当软件包作为库导入时,主机进程 argv 永远不会泄露到配置中.

默认情况下 Stdio 服务器会登记所有五个工具 . --tools 使用逗号分隔的工具名称和注册列表 仅限 因此不需要迅速的工程 来让特工远离他们

# Read-only agent: it can watch the portfolio but not touch it
npx @backtest-kit/mcp --tools get_status

# Observe and exit, but never open or average
npx @backtest-kit/mcp --tools get_status,close_position,notify_user

{
  "mcpServers": {
    "trading-signals": {
      "command": "npx",
      "args": ["@backtest-kit/mcp", "--tools", "get_status,close_position"]
    }
  }
}

有效名称正是代理商看到的工具名称: get_status, (中文(简体) ), open_position, (中文(简体) ), close_position, (中文(简体) ), average_position, (中文(简体) ), notify_user。未知名称 启动失败 加上未知和可用的名称列表——一个无声地扔出一个工具的打字会只是后来的奇特代理行为而浮出水面.

这是运输层的收缩 独立于发动机的 permissions 字段在 MCP 计划中。 两者作曲: --tools 决定提供什么代理, permissions 决定引擎接受什么 在这里限制一个工具是方便的,可以运行几个代理商对一个具有不同授权的交易过程;对真实的边界执行属于计划,代理商无法绕过.

默认情况下服务器会说话 静态: 毒剂产出这个过程,然后通过stdin/stdout与它交谈. --sse 换那个 SSE 通过 HTTP,因此客户端可以附加到整个网络,而不是拥有进程:

# Default port 8080
npx @backtest-kit/mcp --sse

# Explicit port
npx @backtest-kit/mcp --sse 9000

有两个终点被曝光:

SSE是一个双通道运输: GET 流为整个会话保持开放,并携带每个服务器 客户端消息,而客户端 POSTs 自己给第二个终点的信息。 这个 sessionId 互相连接,所以 多个客户端可以同时附加 - 每个人有自己的会议,闭幕会议不会打扰其他会议.

将一个外部 MCP 端点连接到本地 HTTP 的连接器 http://localhost:8080/sse。启动行写给 标准永远不要脱口而出,所以同样的二进制可以被管道 无论是哪种方式,而不腐败 JSON-RPC流.

--sse 由其他一切组成—— --tools 仍然缩小地表, --host 编号 : --port 仍然指向交易桥(说明 引擎 生活,这与 代理人 连接 :

npx @backtest-kit/mcp --tools get_status --sse 9000

可选值为位置,所以在国旗被读作"端口"之后立即有一个路径:

npx @backtest-kit/mcp --sse ./strategy.ts   # ✗ fails: "./strategy.ts" is not a port
npx @backtest-kit/mcp ./strategy.ts --sse   # ✓ path first, then the flag

非端口值 启动失败 而不是被忽略——默默地将它视为"没有给定的港口"会吞噬战略路径,从没有加载开始.

agent (Claude / any MCP client)
  └─ stdio JSON-RPC ─ backtest-kit-mcp          (this package, binary)
       tools/*.tool.ts
       └─ MCPCommandService ── HTTP POST ──► serve()   (this package, imported)
                                              routes/mcp.ts
                                              └─ MCPPublicService ─► MCP.* (backtest-kit)
                                                                      └─ Live.commitCreateSignal / commitClosePending

Stdio过程从不触及交易状态——它只会说HTTP. 交易过程登记计划,运行 Live,并回答 /api/v1/mcp/*。两个角色在一个包里: 导入它给你 serve(),执行它启动 stdio 服务器(一个入门点的守护使副作用在库模式下导入了禁用).

HTTP处理器从不通过状态代码信号操作失败. 每一个反应都是 200 改为:

{ "data": …, "status": "ok",    "error": "",                          "requestId": "…", "serviceName": "…" }
{            "status": "error", "error": "MCP Error: no active position for BTCUSDT" }

MCPCommandService 抛出时 error 非空; 工具抓取并返回消息为 isError. 运输级别的故障(引擎向下,错误的端口)同样通过 fetchApi这是例外.

请求信封 : { clientId, serviceName, userId, requestId, data }编辑 mcpName 已解析服务器侧 : CC_MCP_NAME 如果设置了, 否则第一个注册的计程器—— 代理人从不需要知道它.

公众表面 —— 说 functions/serve.function.ts (单位:千美元)serve编号 :getRouter, (中文(简体) ), functions/setup.function.ts (单位:千美元)setLogger, (中文(简体) ), config/params.ts (单位:千美元)setConfig编号 :getConfig, (中文(简体) ), index.ts 再出口+ lib 集装箱.

Stdio 服务器 —— 说 main/entry.ts (McpServer + StdioServer Transport,通过 helpers/getEntry.ts, (中文(简体) ), --tools 选择通过 helpers/getArgs.ts, (中文(简体) ), tools/get_status.tool.ts, (中文(简体) ), tools/open_position.tool.ts, (中文(简体) ), tools/close_position.tool.ts, (中文(简体) ), tools/average_position.tool.ts, (中文(简体) ), tools/notify_user.tool.ts (经批判的论据, isError 绘制地图).

HTTP 桥 —— 说 config/router.ts (微分+路由器+CORS, /api/v1/mcp/* 挂载, routes/mcp.ts (5个POST处理器,总是 -200信封), routes/health.ts。 。 。 .

服务层 (单位:千美元)lib/services/:

• command/MCPCommandService.ts 工具使用的HTTP客户端(fetchApi 反对 CC_MCP_HOST:CC_MCP_PORT) (中文(简体) ).
• public/MCPPublicService.ts ——服务器端条目:解析 mcpName (单位:千美元)CC_MCP_NAME 或第一个计划,验证论点,代表下来.
• private/MCPPrivateService.ts - 薄薄的伐木代理在后台测试设备上 MCP 单通.
• base/LoggerService.ts 默认不操作(保持 stdio stdout 干净);通过 setLogger。 。 。 .

DI 配置 —— 说 lib/core/{di,provide,types}.ts, (中文(简体) ), lib/index.ts (集装箱靴子), utils/omit.ts (log有效载荷修剪).