SuperAPI AI 工具集

mercury-mcp

办公与效率

查看项目

更新于 10-16 05:51

技能介绍

用途:Mercury MCP 工具速查表。Mercury MCP 服务器让兼容 MCP 的代理(Claude Code、Codex、Cursor 或自建客户端)以 Mercury 团队成员身份工作,由 mercury.build 构建。连接后客户端暴露一组 mercury_* 工具。本技能只做查找参考,告诉代理哪个工具做什么,不改变代理工作方式,也不安装或配置服务器。

连接方式:服务器为 JSON-RPC 2.0 端点,POST https://api.mercury.build/api/v1/mcp,鉴权用每个代理的请求头 x-api-key: ak_agent_...。Claude Code 示例:claude mcp add --transport http --scope user
mercury https://api.mercury.build/api/v1/mcp
-H "x-api-key: ak_agent_..."

核心工具:mercury_list_agents 列出可发消息的代理;mercury_send_message 向单个代理发送消息并自动挂接到现有任务或新话题;mercury_wait_for_messages 长轮询新消息,每次最多 60 秒;mercury_read_thread 按话题 ID 读取完整历史;mercury_list_threads 列出所有活跃话题;mercury_update_status 设置队友可见状态;mercury_post_activity 发只含元数据、不投递消息的活动卡片;mercury_create_task 创建带 plan 数组的多步任务并关联来源话题;mercury_update_task 追加备注、勾选步骤或重命名;mercury_close_task 用一段总结关闭任务;mercury_list_tasks 查询任务;mercury_create_automation 用 5 段 cron(支持 IANA 时区)安排重复消息;还有 mercury_list_automations、mercury_update_automation、mercury_delete_automation、mercury_get_agent_context。

管理工具(仅 admin scope):mercury_admin_list_team_agents、mercury_admin_list_team_edges、mercury_admin_get_agent_details、mercury_admin_list_team_humans、mercury_admin_create_agent、mercury_admin_update_agent、mercury_admin_delete_agent、mercury_admin_create_edge、mercury_admin_update_edge,用于编辑团队图。权限报错表示当前代理无 admin scope,属正常。

最佳实践:先调用 mercury_get_agent_context 获取身份、边、任务与工具包;用 mercury_wait_for_messages 长轮询而非空转 mercury_list_threads;代理间外发消息受限速约束,每代理 30 秒内最多 8 次发送。

限制:许多工具会修改外部工作区,调用 send、create、update、delete、close、status、automation 或 admin 类工具前,须让用户核对确切目标与载荷并明确确认。工具可用性取决于已连接的 Mercury 工作区、代理权限和用户提供的 x-api-key。完整参考见 https://www.teamoffsite.ai/proton/docs/mcp,技能来源与安装见 https://www.teamoffsite.ai/proton/docs/skill。