inbin

@inbin/mcp

适用于 Inbin 的 Model Context Protocol 接口的极简 stdio-to-HTTP 代理。让仅支持 stdio 的 MCP 客户端（Claude Desktop、 部分 Cursor 版本、Zed、Cline）能够与 Inbin 的远程端点 https://api.inbin.dev/mcp 通信。

安装与运行

无需全局安装。MCP 客户端通过 npx 调用它：

{
  "mcpServers": {
    "inbin": {
      "command": "npx",
      "args": ["-y", "@inbin/mcp"],
      "env": {
        "INBIN_API_KEY": "ink_live_..."
      }
    }
  }
}

前往 https://inbin.dev/dashboard 获取 API 密钥。

功能

• 将每条 stdin JSON-RPC 消息转发到 https://api.inbin.dev/mcp， 以 HTTPS POST 方式发送，并附上你的 Bearer 密钥。
• 将响应流式传回 stdout。
• 根据 JSON-RPC 规范，不回复通知（不含 id 的消息）。
• 支持并发处理请求。

暴露的工具

每个 Inbin 应用都是一个 MCP 服务。可用工具：

• list_inboxes — 列出应用中的收件箱
• list_events — 按收件箱 / 状态 / 时间筛选；支持分页
• search_events — 在 id / 主题 / 发件人 / 收件人中进行子串搜索
• get_event — 获取单个事件的解析后 JSON 和投递历史
• query_events — 对提取的记录进行筛选、排序、分组和聚合 （将收件箱视为一张表）
• describe_schema — 查看当前提取架构

环境变量

变量	必需	说明
INBIN_API_KEY	是	你的 Inbin API 密钥
INBIN_MCP_URL	否	覆盖端点（默认使用生产环境）
INBIN_MCP_DEBUG	否	设为 1 可将日志输出到 stderr

远程连接（推荐）

如果你的 MCP 客户端支持 Streamable HTTP 传输，可完全跳过此包装器，直接连接：

{
  "mcpServers": {
    "inbin": {
      "url": "https://api.inbin.dev/mcp",
      "headers": {
        "Authorization": "Bearer ink_live_..."
      }
    }
  }
}

许可证

MIT。