orita-provider-resolution

orita-mcp

用于 Orita Provider Resolution API 的 MCP 服务 — 让 AI Agent 能搜索服务提供者网络、应用资格规则、解析可用情况并安全地确认预约。

功能介绍

Orita 解决服务提供者路由问题：

您的应用知道客户需要什么服务，但不知道哪些专业人员符合资格且有空。

此 MCP 服务将该解析工作流作为工具开放，供 AI Agent（Claude、Cursor 及兼容客户端）直接调用。

主要工作流

resolve_scheduling          → search provider network, return ranked options
hold_scheduling_option      → temporarily reserve the selected slot
confirm_scheduling_resolution → confirm booking after customer approval

工具

工具	描述	是否修改状态？
resolve_scheduling	搜索服务提供者网络、应用资格规则，并返回附有说明的排名选项	否
get_resolution	获取解析结果，包括选项、排除项和过期时间	否
hold_scheduling_option	临时保留时段（默认 2 分钟，最长 10 分钟）	由应用定义
release_scheduling_option	释放已保留的时段	是
confirm_scheduling_resolution	获得客户批准后创建预约	是 — 需要批准
reschedule_booking	改为新的已批准时段	是 — 需要批准
cancel_booking	取消预约	是 — 需要批准
get_booking	获取预约详情	否
list_professionals	列出网络中的服务提供者	否
get_slots	获取已知服务提供者的时段	否

Agent 安全

✓ resolve_scheduling, get_resolution, list_professionals, get_slots
  → No customer approval required

⚠ hold_scheduling_option
  → Application-defined

✗ confirm_scheduling_resolution, reschedule_booking, cancel_booking
  → Require explicit customer approval before calling
  → Display provider, service, time, timezone, and cancellation policy first

在客户明确批准以下内容之前，绝不要调用 confirm_scheduling_resolution：

• 服务提供者姓名
• 服务
• 日期和时间
• 时区
• 取消政策

通过远程服务连接

{
  "mcpServers": {
    "orita": {
      "url": "https://orita.online/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ORITA_API_KEY"
      }
    }
  }
}

注意： 请求必须包含 Accept: application/json, text/event-stream。兼容 MCP 的客户端会自动发送此标头。

通过 PyPI 安装

pip install orita-mcp
ORITA_API_KEY=orita_... python -m orita_mcp

获取 API 密钥

在 orita.online/sign-up 免费注册，无需信用卡。免费套餐包含 50 位活跃服务提供者，每月可进行 5,000 次解析。

资源

• 开发者文档
• MCP 文档
• API 参考
• OpenAPI 规范
• Node.js SDK
• Python SDK