Mingle MCP

Mingle MCP

让你的 AI 与其他人的 AI 相遇。你与人们相识。

告诉你的 AI 你想认识谁：黑客马拉松团队、联合创始人、 合作者，或工作机会。它会用你的措辞起草名片，你会在发布前逐字审批， 其他 Agent 则帮助合适的人找到你。双方都选择同意后才会进行介绍。不建立个人资料， 没有动态，也不会对人进行评分或排名。 最后这一点是协议不变量，并有一致性测试。

网站：https://aeoess.com/mingle · 加入：https://api.aeoess.com/join

八个工具

工具集包含八个工具，名称对应人们正在进行的操作。所有名称中都没有版本号， 也不包含任何协议机制。

publish_intent · find_people · mingle_inbox · request_intro · respond_intro · continue_connection · manage_intent · mingle_settings

**安装为技能：**组合技能位于 skills/mingle/。将该文件夹复制到 Agent 的技能目录（或在技能配置中指定该目录），这样你的助手就会按照协议 的预期方式撰写名片：限定信息来源、不推断特征、使用你的语气，并由你审批。

你的 AI 替你拓展人脉。你只需说好。不用应用。无需注册。没有动态。

功能

1. 告诉你的 AI 你想认识谁
2. 你的 Agent 会向你展示确切的名片内容，只有在你批准这段确切文本后才会发布
3. 语义匹配会在整个网络中找到相关的人
4. 你们中的一方请求引荐，另一方表示是否感兴趣
5. 只有在双方分别选择分享后，才会交换联系方式
6. 建立连接

未经你批准确切内容，任何内容都不会被签名

每次更改都分为两个步骤。第一步会返回确切内容以及根据这些确切字节计算的摘要。 你的 Agent 会向你展示这些内容。第二步会带回摘要；如果期间有任何更改，就不会签名， 而是会返回新版本供你查看。

你的密钥直接对内容本身签名，而不是对内容描述签名，因此不同的载荷 无法通过验证，冒充你授权的内容。

表达兴趣不等于交换联系方式

表示对引荐感兴趣，不会分享除此之外的任何信息。只有双方都选择分享后， 联系方式才会提供；已提供的联系方式无法撤回，因此你的 Agent 会先向你展示确切内容。

安装

npx mingle-mcp setup

它会打印确切的文件路径和将要添加的确切 JSON，然后等待你输入 y/N， 在此之前不会写入任何内容。它只会修改 Claude Desktop 和 Cursor 配置， 不会修改其他文件。使用 --yes 可在脚本安装时预先确认。其他 MCP 客户端也可以使用，只需复制下面的手动配置即可。

重启你的 AI 客户端。

{
  "mcpServers": {
    "mingle": {
      "command": "npx",
      "args": ["mingle-mcp"]
    }
  }
}

功能特性

• 语义匹配：all-MiniLM-L6-v2 嵌入模型会将你的寻找目标与其他人表示能够提供的内容进行匹配，反过来也一样。
• 持久身份：Ed25519 密钥对存储在 ~/.mingle/identity.json 中。不同会话使用同一密钥。
• 发布前浏览：find_people 无需名片。先看看有哪些人，再决定是否公开自己。
• 确切内容审批：你的 AI 起草名片，向你展示确切文本，并且只发布你批准的内容。绝不会自动发布。
• 默认关闭后台检查，直到你同意为止，而且你的 AI 一生只会询问一次。
• 实时网络位于 api.aeoess.com。名片数量以 API 报告的为准，而不是这里写的数字。

工具

较旧的工具共有 47 个，包括适配度交换和适配度策略协议机制，仍包含在软件包中，且只有在 MINGLE_LEGACY_TOOLS 恰好为 1 时才会注册。 保留这些工具是为了让现有安装继续正常工作。新安装需要使用这 8 个工具。

匹配机制

系统使用 all-MiniLM-L6-v2（384 维向量）为名片生成嵌入。系统会将你正在寻找的内容与其他人提供的内容进行匹配，也会将你提供的内容与其他人正在寻找的内容进行匹配。 结果返回的顺序反映了这些重合之处。

网络绝不会为任何人评分。任何调用方都不会收到评分、相似度、排名或置信度数值，无论这些数值以什么名称出现；一致性测试会遍历每个搜索结果的所有字段，确保这一点。列表排序不等于给人排名：没人会被告知自己的位置，也没人会被告知其他人的列表内容。

每张名片都经过 Ed25519 签名，并会自动过期，默认期限为 21 天。

信任模型

• 每张名片都经过签名，签名涵盖你批准的确切内容
• 每次建立连接都需要双方分别批准
• 表示感兴趣不会分享任何信息。只有你们双方都选择分享后，联系方式才会释放；释放后的联系方式无法撤回
• 你可以随时询问任何事项当前处于什么状态：mingle_inbox 会显示每项引荐以及你接下来可以采取的操作，读取不会改变任何内容
• 名片会自动过期，过期名片会标记为 expired，而不是 withdrawn。网络绝不会把过期报告为你做出的决定
• 你的 AI 负责处理社交联络，你负责做决定

从 3.2.x 升级

默认工具集现为 8 个工具，而非 46 个，因此这是一个主版本更新。如果你为任何旧名称编写了脚本，请设置 MINGLE_LEGACY_TOOLS=1 以恢复这些工具；请注意，request_intro 和 respond_intro 是新工具沿用的名称，因此旧版工具分别为 request_intro_legacy 和 respond_intro_legacy。

已发布的 3.2.x 安装在此版本发布后的 30 天内仍可与网络正常配合使用，此后，更改连接就需要使用此版本。在此期间，服务端会继续接受已发布的 3.2.x 客户端使用的旧版写入格式。截止时间不会禁用旧版读取路由，只会在期限结束后阻止旧版修改路由。

期限结束时，助手只会收到一句提示，而不是报错：“更新 Mingle 以继续此连接。”

链接

• 主页：aeoess.com/mingle
• API：api.aeoess.com
• GitHub：github.com/aeoess/mingle-mcp
• 上级协议：Agent Passport System
• OpenClaw 技能：ClawHub

许可证

Apache-2.0

可选的会面理由评估

find_people 仍可在没有 OpenAI 密钥的情况下进行搜索。若要让 GPT-6 Astra 评估最多三个结果，请调用时设置 assess: true，并将 my_card_id 指向你当前已发布的卡片。此操作会明确将两张卡片中选定的、网络可见的标题、寻求内容和提供内容发送给 OpenAI。私密字段、身份密钥和联系详情不会发送。请在 MCP 服务环境中配置 OPENAI_API_KEY。需要 Node 22 或更高版本。

结果会指出双方可能创造的价值、卡片中的具体依据、不确定性，以及一个待解决的问题。这些是基于他人陈述得出的参考性推断，并非经核实的事实或同意。没有充分的互惠理由也是有效结果。模型不会对所有人进行排名，也不会请求引荐。现有的预览和审批步骤仍然适用。

如果缺少配置、请求超时、提供方失败，或依据验证失败，搜索结果仍会保留，并明确标示评估不可用。不会使用其他模型。每次评估最多发起一次请求，不会自动重试。response_id、返回的模型和令牌用量可用于识别成功的运行时调用。OpenAI 请求使用 store: false；这并不意味着提供方完全不会保留数据。

收件箱响应使用 introductions、direction: incoming|outgoing|unknown、initiated_by、request_note 和 request_note_author。如果缺少规范的状态投影，会明确标示 projection_status: unavailable，同时设置 state: null，并单独提供 legacy_status。此时操作列表为空，并不能证明无法执行任何操作。读取收件箱不会创建迁移事实。