AI导哈

协作MCP服务

Collab MCP是一个轻量级服务器，通过MCP协议将OpenClaw代理的工作空间内容暴露给兼容工具，实现代理身份、记忆和上下文的共享。

  • by collabs-inc
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 collaborator-ai/collab-mcp

使用说明

环MCP

拉你的 开爪 代理到任何兼容MCP的工具中——Claude Code、Codex、Cursor或任何讲MCP的工具。

你的代理人已经有了一个角色、记忆和背景。Collab MCP使您在任何工作场所都可以使用。

它的作用

Collab MCP是一个轻量级服务器，它读取代理的工作区，并通过以下方式公开三个工具 主控程序:

工具 它做什么
代理引导 将代理的身份、内存、姿态和当前状态加载到新会话中
召回 在代理人的记忆和笔记中搜索特定主题的上下文
记录 将观察结果、决策和经验教训写回代理的记忆中

当你在Claude Code（或任何MCP客户端）中调用你的代理时，它会带着它所知道的一切——你的目标、最近的决定、悬而未决的问题以及它自己的意见。它不是从头开始的。

运作原理

OpenClaw代理的工作区是一个包含markdown文件的文件夹：

~/.openclaw/workspace/
├── SOUL.md          # Who the agent is
├── USER.md          # Who it's working with
├── IDENTITY.md      # Name, emoji, metadata
├── MEMORY.md        # Long-term memory
├── memory/          # Daily notes (YYYY-MM-DD.md)
├── notes/           # Check-in notes
└── initiative/      # Initiative pipeline output
    └── output/
        └── YYYY-MM-DD/
            └── initiative_brief.md

Collab MCP读取这些文件并通过MCP提供这些文件。就是这样。没有数据库，没有云同步，也不需要帐户。你的代理人的工作空间是真相的来源。

如果您的代理人使用 种子库 对于音符同步，Collab MCP还可以通过 recall 工具。

安装

选项A：让你的代理人来做

如果您正在运行OpenClaw代理，请为其提供设置技能：

Read https://raw.githubusercontent.com/collaborator-ai/collab-mcp/main/SKILL.md and follow it.

您的代理将克隆仓库，安装依赖项，配置服务器，并将其连接到您的编码工具。您可以先查看技能文件——它简短易读。

选项B：自己动手

# 1. Clone and build
git clone https://github.com/collaborator-ai/collab-mcp.git
cd collab-mcp
npm install
npm run build

# 2. Set environment variables
export OPENCLAW_WORKSPACE=~/.openclaw/workspace    # Path to your agent's workspace
export OPENCLAW_AUTH_TOKEN=$(openssl rand -hex 16)  # API key for connections
export PORT=3100

# 3. Start the server
node build/index.js

# 4. Connect to Claude Code
claude mcp add collab --transport sse \
  "http://localhost:3100/mcp/sse?key=$OPENCLAW_AUTH_TOKEN"

就是这样。打开克劳德代码，你的代理的上下文就可用了。

法典

codex mcp add collab --url "http://localhost:3100/mcp?key=$OPENCLAW_AUTH_TOKEN"

远程访问

从其他机器进入时，在前面放一条隧道：

cloudflared tunnel --url http://localhost:3100

然后设置 PUBLIC_URL 转到隧道URL并在您的 claude mcp add 命令。

环境变量

变量 必填 描述
OPENCLAW_WORKSPACE 是 代理工作区的路径
OPENCLAW_AUTH_TOKEN 推荐的 API密钥用于MCP连接。没有它，服务器是开放的。
PORT 无 服务器端口（默认值：3100）
TRANSPORT 没有 sse 或 stdio （默认值： sse)
PUBLIC_URL 否 如果位于隧道后面，则为公共URL
SV_SERVER 否 Seedwault服务器URL
SV_TOKEN 否 Seedvault API令牌
SV_CONTRIBUTOR 无 Seedwault贡献者可供搜索

你的代理人看到了什么

当编码工具调用时 agent-bootstrap，它收到：

  • 角色 --从 SOUL.md （代理人是谁，它怎么想）
  • 操作说明 --从 AGENTS.md
  • 用户配置文件 --从 USER.md
  • 当前状态 --来自最新的倡议简报（什么是活动的，什么是卡住的）
  • 主动姿态 --从记忆中提取的意见和决定
  • 最近环境 --来自每日笔记和签到

代理人没有背这句话。它将其内化，以当前的回购为导向，并根据它所知道的一切提出要做什么。

安全

  • 服务器仅从您的本地工作区读取。除非配置Seedfault，否则不会向外部服务发送任何内容。
  • auth令牌是一个简单的API密钥，作为URL参数传递。这适合当地使用。对于远程访问，请始终使用HTTPS（例如Cloudflare隧道）。
  • OAuth 2.1也支持需要它的客户端（例如Claude Desktop）。流程自动批准——无登录页面。

许可证

麻省理工学院

相关 MCP