io.github.amvaleh由 GitHub 账号 amvaleh 发布v1.0.1更新于 Oct 24, 2026
Search and book real photographers on Kadro (Iran) on a user's behalf, ending with a payment link.
让助手搜索 Kadro 上伊朗的摄影师与套餐，并代为创建预订占位，最后给出付款链接由用户自行完成支付。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.amvaleh%2Fkadro-mcp-server/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"kadro": {
"type": "http",
"url": "https://www.shootempire.com/kadro-mcp-relay/mcp"
}
}
}An MCP (Model Context Protocol) server that lets AI assistants search Kadro
photographers/packages and book a guest reservation on a user's behalf,
ending with a payment link — the assistant never touches payment or login
itself. It's a thin wrapper around Kadro's Api::Agent::V1 REST API (see
the Main-Rails repo, app/controllers/api/agent/v1/).
search_shoot_types — list service types and their ids.search_photographers — find photographers for a shoot_type_id (+ optional city_id).get_photographer_packages — a photographer's real packages and prices.create_reservation — place a 15-minute guest hold. No payment involved.get_payment_link — a URL for the human to open themselves to verify their
phone and pay. This is the boundary: no tool here ever asks for or handles
card details, OTP codes, or passwords.get_reservation_status — check payment/confirmation status. Paid is not
the same as confirmed — see the tool description.The registration is self-service and instant, capped at a daily_limit of 5
requests/day by default (see ApiPartner in Main-Rails). Email Kadro to
request a higher limit for this server's token once it's actually deployed.
This is a separate Node process from the Rails app — it does not go through Capistrano. A reasonable setup, matching this server's existing Docker usage for other services (gitlab, typesense):
Build and run the Docker image above on the server (or run
npm run build && npm start under a process manager like systemd or pm2).
Point a path or subdomain at it through whatever already terminates TLS for kadro.co (nginx, based on the existing setup). Example nginx snippet — adjust to match the real server-block layout, this repo has no visibility into it:
The public MCP endpoint ends up at something like https://www.kadro.co/mcp
or https://mcp.kadro.co/mcp — whichever this repo's operator prefers. Put
that URL in public/llms.txt (Main-Rails) once it's live, alongside the
plain REST API section already there.
来源：README.md，提交 fece373
Search Kadro shoot types
List the photography/videography service types Kadro offers (e.g. wedding, industrial, portrait), each with a numeric shoot_type_id. Call this first if you don't already know the id for the kind of shoot the user wants.
无需输入参数。
Search Kadro photographers
Find real, bookable photographers for a given shoot_type_id (from search_shoot_types), optionally narrowed to a city_id. Returns each photographer's uid (needed for every later call), display name, rating, review count, and city.
city_idshoot_type_id必填Get a photographer's packages and prices
List the real, currently bookable packages (with prices, in Toman) a specific photographer offers for a given shoot_type_id. Rejects the shoot_type_id if that photographer doesn't actually offer it. Use the returned package id with create_reservation.
shoot_type_id必填photographer_uid必填Create a guest photographer reservation
Book a specific photographer for a specific package, date/time, and address on the user's behalf — no login required. This only places a 15-minute hold; it does NOT charge any money and does NOT require or accept any payment information. Immediately follow this with get_payment_link and give that URL to the human — they open it themselves to verify their phone number and pay. start_time must be an ISO 8601 timestamp at least 6 hours in the future. Pass a stable idempotency_key if you might retry this call, so a retry can't create a second reservation.
city_id必填package_id必填start_time必填shoot_detailshoot_type_id必填address_detail必填idempotency_keyaddress_latitude必填photographer_uid必填address_longitude必填guest_display_nameGet the payment link for a reservation
Get a URL for the human to open in their own browser to finish this reservation: verify their phone number by SMS code and pay. This is the last step this server ever takes — never ask the user for a card number, OTP code, or password, and never try to open, submit, or complete this URL yourself. Just hand the URL to the user.
slug必填Check a reservation's status
Check whether a reservation has been paid and confirmed. IMPORTANT: status values are 'awaiting_payment', 'expired', 'paid_awaiting_photographer_confirmation', 'confirmed', and 'rejected'. 'paid_awaiting_photographer_confirmation' means the customer paid but the photographer has not yet accepted the booking and could still decline or ask to reschedule — do not tell the user their booking is final until status is exactly 'confirmed'.
slug必填已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
npm installcp .env.example .envnpm run register -- "your-platform-name" "[email protected]" # prints a token# paste the printed KADRO_API_TOKEN into .envnpm run buildnpm start # listens on :3100 (or $PORT), MCP endpoint is POST /mcpdocker build -t kadro-mcp-server .docker run -p 3100:3100 --env-file .env kadro-mcp-serverlocation /mcp { proxy_pass http://127.0.0.1:3100/mcp; proxy_set_header Host $host; proxy_http_version 1.1; proxy_set_header Connection "";}curl https://<wherever-it's-deployed>/healthz # -> ok