agentdraft-mcp — 面向 AgentDraft 的 MCP 服务器

一个 MCP 服务器，将 AgentDraft —— 面向 AI 代理的运维 API，提供收件箱、无冲突日历和审计工具 —— 以一组工具的形式暴露出来，任何支持 MCP 的 AI 客户端都可以调用。

如果你的代理运行时是 Claude Desktop、Claude Code、Cursor、 Cline、OpenAI Agents SDK 应用或任何其他 MCP 主机，都可以使用本服务器。该服务器是 agentdraft Python SDK 的轻量封装 —— 与 REST API 和语言 SDK 具有相同的认证、相同的错误、相同的语义。

安装

pip install agentdraft-mcp

需要 Python 3.10+ 以及来自 AgentDraft 控制台的有效 avs_live_… 代理密钥。

Related MCP server: Labradoc MCP Server

升级

pip install -U agentdraft-mcp

发布说明：https://agentdraft.io/changelog

配置你的 MCP 客户端

agentdraft-mcp 已发布在 PyPI 上，因此安装后，下面的 JSON 配置 即可在任何 MCP 主机上立即生效 —— 无需额外下载。

Claude Desktop / Claude Code —— JSON 配置（推荐）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 Windows/Linux 上的对应文件：

{
  "mcpServers": {
    "agentdraft": {
      "command": "agentdraft-mcp",
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

Cursor / Cline / 通用 stdio 主机

{
  "mcpServers": {
    "agentdraft": {
      "command": "python",
      "args": ["-m", "agentdraft_mcp"],
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

如需针对开发后端进行本地开发，还需设置 AGENTDRAFT_BASE_URL=http://localhost:8080。

Claude Desktop —— .mcpb 桌面扩展（拖放）

每个版本还会在 GitHub Releases 上发布一个 .mcpb 桌面扩展包。将 agentdraft-mcp.mcpb 拖入 Claude Desktop → 设置 → 扩展，然后粘贴你的 avs_live_… API 密钥 —— 无需编辑 JSON，也无需 pip install。

工具

所有时间均为 ISO 8601 字符串（2026-06-01T14:00:00Z）。所有写入 工具都接受 idempotency_key 以便安全重试。create_hold 和 commit_booking 还接受可选的 title 和 invitee （{name, email, notes}），用于记录该时段是为谁预留的 —— 会在控制台中显示给所有者。

冲突如何呈现

当两个代理竞争同一个时段时，恰好只有一个获胜。落败的 代理会收到一个结构化的 outranked 负载 —— 而不是字符串错误：

{
  "error": "outranked",
  "winning_booking_id": "bkg_…",
  "winning_agent_id": "agt_…",
  "winning_agent_priority": 1,
  "your_priority": 3,
  "message": "Your booking was outranked. Read winning_agent_id and propose an alternate slot rather than retrying."
}

你的代理应基于此进行分支处理并提出替代方案，而不是重试 同一个时段。

与 AgentDraft SDK 的区别

当你自己编写代理时，请使用 SDK。当别人的代理运行时（Claude Desktop、Cursor、Cline、 通用 MCP 主机）需要代表用户调用 AgentDraft 而无需自定义代码时，请使用此 MCP 服务器。

链接

• 协议规范：https://agentdraft.io/spec

• API 文档：https://agentdraft.io/docs

• 变更日志：https://agentdraft.io/changelog

• Python SDK：agentdraft

• TypeScript SDK：agentdraft

• 源代码：https://github.com/ryabinski-labs/agentdraft-mcp

• 问题：https://github.com/ryabinski-labs/agentdraft-mcp/issues

安全

发现漏洞？请参阅 SECURITY.md。不要为安全报告 打开公开问题。

贡献

请参阅 CONTRIBUTING.md。ryabinski-labs/agentdraft-mcp 是 AgentDraft 私有应用仓库中某个目录的公开镜像 —— 问题和拉取请求会在那里被阅读，并通过下一次发布同步合并回来。

许可证

MIT —— 请参阅 LICENSE。