Synap

Synap MCP 服务

Linkrra 的 Synap 作为模型上下文协议服务：通过一个兼容 OpenAI 的 API 调用开放模型。你的 Agent 可以列出我们提供的模型、查看其价格和限制、在运行任务前估算成本，并运行聊天补全。

此服务只有一个实例，托管于 https://pool.linkrra.com/mcp（Streamable HTTP）。它是 官方 MCP 注册表中 com.linkrra/synap 背后的服务。

此仓库包含两部分：

• routes.js 是已部署的路由器本身，逐字节保持一致。
• bin/synap-mcp.js 是 stdio 传输层（npx synap-mcp），供启动本地命令的 MCP 主机使用。它会原样将每条消息发送到托管服务，因此始终提供与托管服务相同的工具。

工具

工具	费用	是否需要密钥
synap_list_models	免费	否
synap_get_model	免费	否
synap_estimate_cost	免费	否
synap_chat_completion	按提示词和补全令牌计费	是

模型 ID 与 synap_list_models 返回的相同。传入 synap-v1，Synap 会选择能够完成任务的最便宜模型。

连接

托管服务（Streamable HTTP），无需安装

{
  "mcpServers": {
    "synap": {
      "type": "http",
      "url": "https://pool.linkrra.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_SYNAP_API_KEY" }
    }
  }
}

本地 stdio（Claude Desktop、Cursor、Cline、Windsurf、Zed）

{
  "mcpServers": {
    "synap": {
      "command": "npx",
      "args": ["-y", "synap-mcp"],
      "env": { "SYNAP_API_KEY": "YOUR_SYNAP_API_KEY" }
    }
  }
}

没有密钥时，三个免费工具仍可正常使用。synap_chat_completion 会返回错误，且不会产生费用。

变量	含义
SYNAP_API_KEY	你的 Synap 密钥，将作为 Authorization: Bearer 发送。请前往 https://synap.linkrra.com 获取。
SYNAP_MCP_URL	可选。覆盖端点（默认值为 https://pool.linkrra.com/mcp）。

在 goose 中使用

goose/ 中提供了现成的 goose 自定义提供商文件。将 goose/linkrra.json 下载到 ~/.config/goose/custom_providers/，设置 LINKRRA_API_KEY，然后选择 Linkrra (Synap) 作为提供商。完整的设置步骤和模型表格见：goose/README.md。

付费

• API 密钥（MCP 和 REST）。 使用银行卡或加密货币为 Synap 账户充值。每次调用都会按令牌数从余额中扣费。MCP 始终使用此方式。
• x402，无需账户。 拥有 Base 上 USDC 钱包的 Agent 可以通过普通 HTTP 向 POST https://pool.linkrra.com/api/billing/x402/chat/completions 按次付费。未付费的请求会返回 402 和付款条款。此路由属于 REST API，而非 MCP 工具。其结算情况由 PayAPI Market 独立验证。

协议

托管服务支持两个时期的 MCP 协议：

• 2026-07-28（当前）： 无状态。它实现了 server/discover，并读取每个请求中的 _meta 协议版本。它会检查 MCP-Protocol-Version、Mcp-Method 和 Mcp-Name 是否与请求正文匹配。结果包含 resultType，列表结果还包含 ttlMs 和 cacheScope。
• 2025-11-25、2025-06-18、2025-03-26、2024-11-05： 使用 initialize 握手。

此桥接程序兼容两者。对于旧版客户端，它会记住 initialize 期间协商的版本。对于 2026-07-28 客户端，它会将 _meta 版本复制到 Streamable HTTP 传输所需的 HTTP 标头中。

背后的 API

https://pool.linkrra.com/v1 是兼容 OpenAI 的 API。对于每个可自托管模型，它都支持工具调用（tools、tool_choice）和结构化输出（response_format 的 json_object / json_schema）。请求可以选择是否以流式方式传输。提示词和补全内容不会被存储。

身份验证

服务只会透传你的密钥，不会进行其他处理。密钥会通过标准的 Authorization: Bearer 标头传输，与直接调用 /v1/chat/completions 时的方式相同。routes.js 会原样转发该标头。服务不会读取、存储或创建密钥。

独立运行服务

npm install && npm start     # serves :8080/mcp

开发

npm test     # offline: a local mock checks the bridge's headers for both protocol eras

stdio 桥接程序需要 Node 18 或更高版本，且没有依赖项。

许可证

Apache-2.0