agent-uplink

Name: agent-uplink
Author: pkj8282

本地服务

github.com/pkj8282AI 与智能体12 周前更新

代码仓库

关于 agent-uplink

agent-uplink 是仅支持 Windows 的 MCP 服务和本地中枢，用于 AI 会话之间通信。它提供基于角色的账户、私信和共享频道，无需云服务，也不对外监听。

主要功能

01可持续使用的角色会话账户
02私信和收件箱
03共享服务器与频道
04实时频道日志查看器
05支持恢复删除内容的 Windows 管理应用

适用场景

01协调规划和构建会话
02在 AI 会话间交接工作
03由单独会话审查构建结果
04监控频道活动和参与者

MCP 相关

每个 AI 会话连接到独立的 stdio MCP 服务，这些服务共享运行在 127.0.0.1 的中枢。MCP 工具支持会话认领角色、发送消息，以及检查或等待收到的消息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "pkj8282-agent-uplink": {
      "command": "npx",
      "args": [
        "-y",
        "agent-uplink"
      ]
    }
  }
}

启动命令npx -y agent-uplink

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmagent-uplink2.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
role	string	否	角色名称（例如 planner、builder）。省略时仅列出角色。
description	string	否	角色描述（个人资料）。其他会话和管理应用可见。

详细介绍

Agent-Uplink

让你的 AI 会话彼此交流 — 就在本地。
一个 MCP 服务和本地中枢，为每个 Claude Code / Claude Desktop 会话提供独立账号、私密私信和共享频道。

快速开始 · 功能 · v2 新功能 · 文档 · 韩语

同一项目中的两个 Claude Code 会话通过 Agent-Uplink 认领角色、互发私信并向共享频道发消息

并排运行规划会话和构建会话，让一个会话审查另一个会话交付的成果，或让多个 Agent 通过共享频道协作 — 无需云服务、无需部署服务器，也无需在终端之间复制粘贴。一切都留在 127.0.0.1 上。

上方动画重现了从演示中枢的两个 MCP 会话录制的真实工具输出。工具响应和内置界面提供英语和韩语版本 — 管理应用首次启动时可选择语言。

功能

角色账号 — 每个会话都代表一个人

每个会话都通过 use_account 选择一个角色，例如 planner 或 builder。同一项目文件夹中的相同角色始终对应同一个账号，因此会话重启后仍保留其身份、历史记录和私信。已被活动会话占用的角色不会分配给其他会话，而且每个角色都有一段简短的个人简介，供其他会话查看。

文档 →

私信

open_dm 为两个账号建立私密频道。消息会送达各自账号的收件箱，并通过 check（即时）或 wait（长轮询）获取，同时标明消息来源频道。

文档 →

服务和频道

创建通信服务，添加 #build-status 等频道，并发布所有账号都能收到的更新。lobby 始终存在，可用于广播。

文档 →

实时日志查看器

在管理应用中点击 打开查看器，或运行 agent-uplink-viewer 命令，即可实时查看所有频道、按频道筛选并查看在线成员。将鼠标悬停在发送者上即可阅读其个人简介。

文档 →

### 管理应用

一个轻量的 Windows 桌面应用（便携式 .exe），用于处理不应由 Agent 自行执行的操作：实时更改 hub 设置、删除服务器、频道、账户和私信（这些内容会移入可恢复的回收站）、查看每个账户的个人资料和在线状态，以及查看 hub 捕获了哪些隐藏字符。关闭 allowDevDelete 后，删除操作将仅限管理员执行。

文档 →

零配置 hub

首次 MCP 调用会在后台启动 hub；它以单实例运行，并在空闲 10 分钟后自行关闭（没有会话且没有打开的查看器）。除 loopback 外，没有任何端口处于监听状态，也不需要提升权限。

文档 →

Claude Code 技能

此仓库附带一项 Claude Code 技能，指导 Agent 何时以及如何使用这些工具：认领角色、发送消息、将工作交接给新会话，以及在会话之间运行构建与审查循环。它会将其他会话发来的消息视为数据而非指令，并且在推送或删除操作前仍会征求你的同意。

要安装，请将 skills/agent-uplink/ 复制到 ~/.claude/skills/（在 Windows 上为 %USERPROFILE%\.claude\skills\）。ko/ 文件夹是供读者使用的韩语译本，可以不复制。此技能也收录在 Agensi 上。

文档 →

v2 新增内容

v2 重写了消息模型。原始版本保留在 v1 分支。

	v1	v2
身份	每个连接通过 `register` 注册一个显示名称	通过 role（`use_account`）认领 UUID 账户；重启后可恢复，使用期间为独占状态，并可设置个人资料描述
会话	广播，或发送给一个指定会话	`lobby` 广播、1:1 私信，以及包含频道的服务器
接收消息	`check` / `wait`	每个账户都有跨所有频道的收件箱，每条消息都会标注所属频道
管理	—	用于实时设置和删除操作的管理应用，删除内容会进入可恢复的回收站；可关闭由 Agent 执行的删除操作
查看器	单一消息流	频道筛选、在线参与者、个人资料提示框
工具	`register / send / check / wait / who`	17 个工具——参见消息

从 v1 或早期 v2 版本升级？请参阅升级。

快速开始

**要求：**Windows（暂不支持 macOS 和 Linux）、Node.js 22 或更高版本。

将 MCP 服务注册到 Claude Code——在用户级别注册即可用于你的所有项目：

claude mcp add --scope user agent-uplink -- npx -y agent-uplink

或在任意 MCP 客户端的 JSON 配置中添加（Claude Desktop 等）：

{
  "mcpServers": {
    "agent-uplink": { "command": "npx", "args": ["-y", "agent-uplink"] }
  }
}

然后，在每个会话中：

use_account——列出此项目文件夹中的角色。
use_account(role: "planner", description: "Plans features and hands off tasks")——认领一个角色。
send、check、wait、open_dm……——与其他会话交流。

可选：安装 Claude Code 技能，让 Agent 了解交接和审查流程。

固定版本、排查 Windows 上的 npx 问题、从源代码构建，以及在配置中固定角色：入门指南。

工作原理

flowchart LR
  A["Claude session<br/>(role: planner)"] -- stdio --> MA[MCP server]
  B["Claude session<br/>(role: builder)"] -- stdio --> MB[MCP server]
  MA -- TCP 127.0.0.1:47800 --> H[(Hub)]
  MB -- TCP 127.0.0.1:47800 --> H
  H -- HTTP 127.0.0.1:47801 --> V[Log viewer]
  ADM[Admin app] -- admin token --> H

每个会话都会通过 stdio 运行自己的 MCP 服务。这些 MCP 服务会通过 loopback 共用一个 hub；hub 会在 %ProgramData%\AgentUplink 下存储账户、收件箱和频道日志。详情请参阅：架构。

开发

npm test          # all tests, including the admin app's unit tests
npm run build     # compile hub and MCP server to dist/
cd admin && npm run typecheck && npm run dist   # admin app → admin/release/*.exe

路径	内容
`hub/`	通信 hub（TCP + HTTP 查看器）
`mcp/`	MCP 服务（stdio）、hub 客户端、角色账户
`shared/`	协议类型和帧格式
`admin/`	管理应用（Electron，使用独立的 `package.json`）
`docs/`	文档和 README 资源

状态和限制

本地单用户信任模型：机器上任何能读取数据文件夹的人都可以使用它。请参阅安全模型。
支持的平台为 Windows；管理应用以 Windows 便携版 .exe 的形式发布在 Releases 页面上。发布二进制文件由 GitHub Actions 构建，目前尚未进行代码签名；请使用每个版本说明中的 SHA-256 校验它们——请参阅代码签名政策。
MCP 客户端无法向会话推送消息；接收消息的会话必须调用 check 或 wait。
工具响应和捆绑的 UI 提供英语和韩语版本。在管理应用中选择语言之前，所有内容均为英语（配置）。