内容
# @inbin/mcp
一款最小化的stdio-to-HTTP代理,用于Inbin的模型上下文协议(MCP)接口。允许仅支持stdio的MCP客户端(如Claude Desktop、某些Cursor版本、Zed、Cline)与Inbin的远程端点`https://inbin.dev/api/mcp`进行通信。
## 安装和运行
无需全局安装。您的MCP客户端通过`npx`调用它:
```json
{
"mcpServers": {
"inbin": {
"command": "npx",
"args": ["-y", "@inbin/mcp"],
"env": {
"INBIN_API_KEY": "ink_live_..."
}
}
}
}
```
从https://inbin.dev/dashboard获取API密钥。
## 功能
- 将每个stdin JSON-RPC消息转发到`https://inbin.dev/api/mcp`,作为带有Bearer密钥的HTTPS POST请求。
- 将响应流式返回到stdout。
- 通知(无`id`的消息)根据JSON-RPC规范不会收到回复。
- 支持并发请求。
## 提供的工具
每个Inbin应用程序都是一个MCP服务器。以下是可用的工具:
- `list_inboxes` — 列出应用程序中的邮箱列表
- `list_events` — 按邮箱、状态、时间过滤;分页
- `search_events` — 在id、主题、发件人、收件人中进行子字符串搜索
- `get_event` — 获取单个事件的解析JSON和投递历史
- `describe_schema` — 当前提取模式
## 环境变量
| 变量名 | 是否必需 | 描述 |
| --- | --- | --- |
| `INBIN_API_KEY` | 是 | 您的Inbin API密钥 |
| `INBIN_MCP_URL` | 否 | 覆盖端点(默认为生产环境) |
| `INBIN_MCP_DEBUG` | 否 | 设置为`1`以启用stderr日志 |
## 远程连接(推荐)
如果您的MCP客户端支持可流式传输的HTTP协议,请直接连接,无需使用此包装器:
```json
{
"mcpServers": {
"inbin": {
"url": "https://inbin.dev/api/mcp",
"headers": {
"Authorization": "Bearer ink_live_..."
}
}
}
}
```
## 许可证
MIT。