kadro-mcp-server

kadro-mcp-server

一个 MCP（Model Context Protocol）服务，让 AI 助手能够搜索 Kadro 摄影师／套餐，并代用户预订访客预约，最后生成付款链接——助手本身不会处理付款或登录。这是对 Kadro Api::Agent::V1 REST API 的轻量封装（参见 Main-Rails 仓库中的 app/controllers/api/agent/v1/）。

工具

• search_shoot_types — 列出服务类型及其 ID。
• search_photographers — 按拍摄类型 ID 查找摄影师（可选城市 ID）。
• get_photographer_packages — 获取摄影师的实际套餐和价格。
• create_reservation — 创建 15 分钟的访客预约保留。无需付款。
• get_payment_link — 提供一个 URL，供用户自行打开以验证手机号并付款。这是安全边界：这里的工具绝不会索取或处理银行卡详细信息、一次性验证码或密码。
• get_reservation_status — 查看付款／确认状态。已付款不等于已确认——请参阅工具说明。

设置

npm install
cp .env.example .env
npm run register -- "your-platform-name" "[email protected]"   # prints a token
# paste the printed KADRO_API_TOKEN into .env
npm run build
npm start   # listens on :3100 (or $PORT), MCP endpoint is POST /mcp

注册可自行办理且即时生效，默认每天最多 5 次请求（参见 Main-Rails 中的 ApiPartner）。此服务实际部署后，请联系 Kadro，为此服务的令牌申请更高的限额。

使用 Docker 运行

docker build -t kadro-mcp-server .
docker run -p 3100:3100 --env-file .env kadro-mcp-server

与 Rails 应用部署在同一台服务器上

这是与 Rails 应用分开的 Node 进程，不通过 Capistrano 运行。一个合理的设置方案是沿用此服务器现有的 Docker 用法（用于 gitlab、typesense 等服务）：

1. 在服务器上构建并运行上面的 Docker 镜像（或在 systemd、pm2 等进程管理器下运行 npm run build && npm start）。

2. 通过当前为 kadro.co 终止 TLS 的设施（基于现有设置的 nginx），将某个路径或子域名指向它。以下是 nginx 配置片段示例——请根据实际的服务器块布局进行调整；此仓库无法查看相关配置：

   location /mcp {
     proxy_pass http://127.0.0.1:3100/mcp;
     proxy_set_header Host $host;
     proxy_http_version 1.1;
     proxy_set_header Connection "";
   }
   

3. 公开的 MCP 端点最终会是类似 https://www.kadro.co/mcp 或 https://mcp.kadro.co/mcp 的地址——由此仓库的运营者决定。上线后，将该 URL 添加到 public/llms.txt（Main-Rails）中，放在现有的纯 REST API 部分旁边。

验证服务是否正常运行

curl https://<wherever-it's-deployed>/healthz   # -> ok