SuperAPI AI 工具集

agent-mcp-host

智能体与模型

查看项目

更新于 10-16 05:45

技能介绍

用途:作为 agent-* 家族的操作端工具,在单一 https 源点(通常是 Tailscale funnel)后托管多个工具的 MCP 服务器,统一处理配对、OAuth 与浏览器登记页面。每个工具仍是独立二进制中的完整 MCP 服务器,由 host 以路径形式挂载(/<name>/mcp)并反向代理。

主要能力:serve 以 --mount slack=agent-slack 之类的形式挂载各工具,启动时按 <binary> mcp --http 127.0.0.1:<port> --oauth <public-url> 派生各工具并注入 audience 与 verify key;host 签发 Ed25519 token,工具侧只校验不签发,因此某工具 token 无法用于其他挂载路径。--tailscale funnel|serve 可自动由 MagicDNS 推导 --public-url,退出时隧道拆除;也可自行提供 --public-url 并自行前置 --http 监听(默认 127.0.0.1:8000)。pair 子命令管理人员:pair add alice --bind slack:workspace=acme 设置各工具命名空间绑定,list 仅列主体与绑定,show 显示配对码,rotate 换码保留绑定,remove 撤销码、refresh token 与会话。

使用方式:serve 不退出,需后台运行;stdout 输出 NDJSON 生命周期事件(如 {"event":"ready"} 与每个挂载的 mount_ready),stderr 输出连接器 URL 与配对横幅。若要自行控制工具进程,可先运行 agent-mcp-host mount-env lin=lin --http 127.0.0.1:9410 --tailscale funnel 获取启动命令,再以 --mount lin=lin@127.0.0.1:9410 挂载。全局参数包括 --format json|yaml|jsonl、--color、--timeout、--debug。人员连接流程为:添加连接器 URL、输入一次配对码(无绑定者再填工具登记表单),之后 30 天浏览器会话覆盖身份,仅需各工具登记。

限制与注意:配对码等同密码,不可写入摘要、提交信息或共享文档,仅告知对应人员;疑似泄露用 pair rotate,彻底撤销用 pair remove。密钥存储于钥匙串服务 app.paulie.agent-mcp-host.mcp,list 不会打印。参考资料为 references/commands.md 与 references/output.md;更详细的费用、平台支持等信息暂未提供。