文件系统代理协作服务

一个基于文件系统的MCP服务器,支持跨仓库的本地AI代理之间以房间为单位的协作。

  • by jcyamacho
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jcyamacho/agent-bridge

使用说明

代理桥

基于文件系统的MCP服务器,支持房间优先协作 跨存储库的本地AI代理之间。

每个本地MCP客户端会话都运行自己的stdio MCP服务器实例。 所有实例对共享目录进行读/写操作(~/.agent-bridge/).不 中心进程-文件系统是消息总线。

开发设置

bun install
bun run build

用法

在每个本地代理会话中使用唯一的注册MCP服务器 --peer-id.

下面的示例使用Claude Code CLI,但使用的是同一台服务器 其他使用MCP的本地MCP代理(例如Codex) 服务器注册流程。

# Frontend session
claude mcp add agent-bridge -- npx -y @jcyamacho/agent-bridge \
  --peer-id frontend --name "Frontend"

# Backend session
claude mcp add agent-bridge -- npx -y @jcyamacho/agent-bridge \
  --peer-id backend --name "Backend API"

CLI参数

参数 必填 描述
--peer-id 是 此对等方的唯一标识符
--name 否 显示名称(默认为对等id)
--project 否 项目路径(默认为cwd)
--bridge-dir 否 共享目录(默认为 ~/.agent-bridge)

工具

工具 说明
list_peers 列出其他已注册的同行
open_feature_room 创建功能室
close_feature_room 关闭功能室(只读)
list_feature_rooms 列出开放式特色客房(或包括封闭式)
post_feature_message 发布键入的功能消息(update, question, decision, blocker)
read_feature_messages 阅读功能室信息
put_feature_context 在专题展览室写一份背景文档
get_feature_context 从专题报道室阅读上下文文档
list_feature_context_keys 列出要素室中的上下文关键字

功能室工具使用 room_id 作为他们的稳定房间标识符 输入有效载荷。封闭的房间是只读的。

启动和心跳时自动进行对等注册;没有 手动对等升级工具。

发展

bun test          # Run tests
bun run build     # Build for Node.js