agent-contacts

用途

agent-contacts 是一个 AI 智能体通讯录（contact book）。它的核心目标是：添加一个 MCP 地址后，让 Claude Code 能够与其他智能体进行通信。当你收到别人给出的 agent/bot URL，或需要查看、删除已有联系人时可以使用它。

主要能力

该技能提供三个命令：

/agent-contacts add <url> —— 添加一个新联系人。
/agent-contacts list —— 显示所有联系人。
/agent-contacts remove <name> —— 移除一个联系人。

添加联系人时，技能会规范化 URL、读取目标的 agent.json 内容并解析出名称、描述、能力以及 MCP 地址，生成唯一 slug，检查是否重复，然后写入本地通讯录，并执行 claude mcp add <slug> --transport http <mcp_url> 将对方注册为 MCP 服务器。移除联系人时，则从通讯录中删除记录并执行 claude mcp remove <slug>。

数据与存储

联系人数据库保存在：

~/.claude/agent-contacts.json

contacts.json 的格式为：

[
  {
    "name": "Your Name",
    "slug": "ivan-schedule",
    "mcp_url": "https://your-agent.example.com/mcp/",
    "discovery_url": "https://your-agent.example.com/.well-known/agent.json",
    "capabilities": ["scheduling"],
    "description": "Scheduling agent for Your Name",
    "added": "2026-02-26"
  }
]

agent-contacts.json 会在第一次执行 add 时自动创建。

使用方式

添加联系人（/agent-contacts add <url>）的执行逻辑如下：

加载已有联系人（若文件存在则读取，否则初始化为空列表）。
规范化 URL：去掉首尾空白并去掉结尾斜杠；如果 URL 不以 agent.json 结尾，则发现地址为 url + "/.well-known/agent.json"；否则发现地址即该 URL，并将 url 截断为 /.well-known/agent.json 之前的部分。
使用 WebFetch 获取 agent.json 内容，然后解析：name = agent_data["name"]；description = agent_data.get("description", "")；capabilities = list(agent_data.get("capabilities", {}).keys())；mcp_url = agent_data["capabilities"][first_cap]["url"]，并确保 mcp_url 以 "/" 结尾。
生成 slug：slug = re.sub(r"[^a-z0-9-]", "", name.lower().replace(" ", "-"))。
检查重复：若已存在相同 slug，则提示联系人已存在。
否则追加新联系人记录并写回 JSON 文件。

保存到 JSON 之后运行：

claude mcp add <slug> --transport http <mcp_url>

并提示："Contact <name> added. Restart Claude Code session to use their tools."

查看联系人（/agent-contacts list）：若文件不存在或为空，提示尚未有联系人；否则逐条打印序号、名称与 slug、MCP 地址以及能力列表。

移除联系人（/agent-contacts remove <name-or-slug>）：参数为名称或 slug（转为小写），在通讯录中匹配 slug 或名称，未找到则提示未找到；找到则从 JSON 中删除对应记录并写回，随后运行：

claude mcp remove <slug>

并提示："Contact <name> removed."

如何与他人分享自己的地址

直接发送链接即可：

https://your-agent.example.com/.well-known/agent.json

如果对方拥有该技能：

/agent-contacts add https://your-agent.example.com

如果对方没有该技能，只需一条命令：

claude mcp add ivan-schedule --transport http https://your-agent.example.com/mcp/

注意事项

agent-contacts.json 会在第一次 add 时自动创建。
Slug 必须唯一（在 Claude Code 中作为 MCP 服务器名称使用）。
MCP URL 必须以 / 结尾（结尾斜杠）。
添加之后，需要开启新的 Claude Code 会话，MCP 工具才可使用。
该技能具有副作用（会执行 claude mcp add/remove），因此设置了 disable-model-invocation: true。

限制

资料的 official_text 为空，暂未提供更多官方说明；除上述内容外，该技能的其他功能、收费、价格、平台、效果或使用步骤暂未提供。

技能介绍

用途