Evc Team Relay MCP

EVC团队中继-MCP服务器

   

授予您的AI代理对黑曜石保险库的读/写访问权限。

你的代理人会阅读你的笔记，创建新的笔记，并在整个过程中保持同步 团队接力 API

适用于 克劳德代码, Codex CLI, OpenCode，以及任何 主控程序-兼容客户端。

______________________________________________________________________

快速开始

1.安装

选项A——来自PyPI（推荐）：

无需安装-- uvx 自动下载并运行。跳到步骤2。

选项B——来源：

git clone https://github.com/entire-vc/evc-team-relay-mcp.git
cd evc-team-relay-mcp
uv sync   # or: pip install .

2.配置您的AI工具

使用Relay凭据将MCP服务器添加到工具的配置中。

Claude Code

增添 .mcp.json 在您的项目根目录中或 ~/.claude/.mcp.json:

{
  "mcpServers": {
    "evc-relay": {
      "command": "uvx",
      "args": ["evc-team-relay-mcp"],
      "env": {
        "RELAY_CP_URL": "https://cp.yourdomain.com",
        "RELAY_EMAIL": "agent@yourdomain.com",
        "RELAY_PASSWORD": "your-password"
      }
    }
  }
}

Codex CLI

添加到您的 codex.json:

{
  "mcp_servers": {
    "evc-relay": {
      "type": "stdio",
      "command": "uvx",
      "args": ["evc-team-relay-mcp"],
      "env": {
        "RELAY_CP_URL": "https://cp.yourdomain.com",
        "RELAY_EMAIL": "agent@yourdomain.com",
        "RELAY_PASSWORD": "your-password"
      }
    }
  }
}

OpenCode

增添 opencode.json:

{
  "mcpServers": {
    "evc-relay": {
      "command": "uvx",
      "args": ["evc-team-relay-mcp"],
      "env": {
        "RELAY_CP_URL": "https://cp.yourdomain.com",
        "RELAY_EMAIL": "agent@yourdomain.com",
        "RELAY_PASSWORD": "your-password"
      }
    }
  }
}

From source (all tools)

如果从源代码而不是PyPI安装，请替换 "command": "uvx" / "args": ["evc-team-relay-mcp"] 与：

"command": "uv",
"args": ["run", "--directory", "/path/to/evc-team-relay-mcp", "relay_mcp.py"]

准备复制的配置模板也在 config/.

3.使用它

您的AI代理现在拥有以下工具：

典型工作流程： list_shares -> list_files -> read_file / upsert_file

身份验证是自动的——服务器登录并在内部刷新令牌。

______________________________________________________________________

远程部署（HTTP传输）

对于共享或服务器端部署，请作为HTTP服务器运行：

# Direct
uv run relay_mcp.py --transport http --port 8888

# Docker
RELAY_CP_URL=https://cp.yourdomain.com \
RELAY_EMAIL=agent@yourdomain.com \
RELAY_PASSWORD=your-password \
docker compose up -d

然后配置您的MCP客户端以通过HTTP连接：

{
  "mcpServers": {
    "evc-relay": {
      "type": "streamable-http",
      "url": "http://your-server:8888/mcp"
    }
  }
}

______________________________________________________________________

安全

与基于shell的集成相比，MCP服务器具有显著的安全优势：

• 不执行shell --所有操作都是通过JSON-RPC进行的Python函数调用，消除了命令注入风险
• 无CLI参数 --凭据和令牌永远不会作为进程参数传递（在中不可见 ps 输出）
• 自动令牌管理 --服务器在内部处理登录、JWT刷新和令牌生命周期；代理人从不接触原始代币
• 键入输入 --所有参数在执行前都会根据JSON模式进行验证
• 单一持久进程 --没有每次调用的shell生成，调用之间没有环境泄漏

注： 如果你正在使用 OpenClaw技能 （bash脚本），考虑迁移到此MCP服务器以实现更安全和可维护的集成。

______________________________________________________________________

运作原理

┌─────────────┐      MCP        ┌──────────────┐     REST API     ┌──────────────┐     Yjs CRDT      ┌──────────────┐
│  AI Agent   │ ◄────────────► │  MCP Server  │ ◄─────────────► │  Team Relay  │ ◄──────────────► │   Obsidian   │
│ (any tool)  │  stdio / HTTP  │ (this repo)  │    read/write   │   Server     │    real-time     │    Client    │
└─────────────┘                └──────────────┘                 └──────────────┘      sync         └──────────────┘

MCP服务器将Team Relay的REST API封装到标准MCP工具中。Team Relay将文档存储为Yjs CRDT，并将其实时同步到黑曜石客户端。代理所做的更改会立即出现在黑曜石中，反之亦然。

______________________________________________________________________

先决条件

• Python 3.10+ 紫外线 （推荐）或pip
• 中继控制平面上的用户帐户

______________________________________________________________________

整个VC工具箱的一部分

社区

• 全vc
• 讨论
• in@entire.vc

许可证

麻省理工学院