关于 Railhook
Railhook 的 MCP 服务可供 AI Agent 发送 Webhook 事件,并管理项目端点、订阅和投递重试。此软件包为无法直接连接远程服务的 MCP 客户端提供 stdio 桥接。
主要功能
- 01发送 Webhook 事件
- 02列出和创建端点
- 03列出和创建订阅
- 04查看并重放投递
- 05支持只读 API 密钥
适用场景
- 01由 AI Agent 发送事件
- 02设置项目 Webhook 端点
- 03检查失败投递并重试
MCP 相关
此软件包将 stdio MCP 客户端桥接到 Railhook 远程 MCP 服务,转发工具列表和调用,不提供自有工具。支持远程 MCP 服务的客户端可直接连接 `https://railhook.io/mcp`。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://railhook.io/mcpclaude mcp add --transport http vadymkykalo-railhook https://railhook.io/mcp{"mcpServers":{"vadymkykalo-railhook":{"type":"http","url":"https://railhook.io/mcp"}}}在 Cursor 中打开{"servers":{"vadymkykalo-railhook":{"type":"http","url":"https://railhook.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"vadymkykalo-railhook":{"type":"http","url":"https://railhook.io/mcp"}}}{"mcpServers":{"vadymkykalo-railhook":{"serverUrl":"https://railhook.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
@railhook/mcp
Railhook MCP 服务的 stdio 桥接程序,供仅能启动本地进程的客户端使用,例如 Claude Desktop。
支持远程服务的客户端(Claude Code、Cursor)应连接到
https://railhook.io/mcp,或者在可自托管时连接到 <your origin>/mcp,并跳过此软件包。该
桥接程序会转发 tools/list 和 tools/call,自身不提供任何工具。
使用
需要 Node.js 18 或更高版本。
{
"mcpServers": {
"railhook": {
"command": "npx",
"args": ["-y", "@railhook/mcp"],
"env": {
"RAILHOOK_API_KEY": "your-project-api-key"
}
}
}
}
| 变量 | 必需 | 含义 |
|---|---|---|
RAILHOOK_API_KEY | 是 | 项目 API 密钥。READ_ONLY 密钥允许使用读取工具,并拒绝所有写入操作。 |
RAILHOOK_BASE_URL | 否 | 默认为 https://railhook.io。可自托管时,将其设为你的源站地址。 |
密钥通过 Authorization: Bearer <key> 发送,绝不会记录到日志中。
工具:send_event、list_endpoints、create_endpoint、list_subscriptions、
create_subscription、list_deliveries、get_delivery、replay_delivery。每项工具都会操作该密钥所属的
项目。
完整指南:https://railhook.io/docs/tools/mcp/
开发
npm ci
npm test
npm run build
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。