EVC Team Relay — MCP-сервер

Предоставьте вашему ИИ-агенту доступ на чтение/запись к вашему хранилищу Obsidian.

Ваш агент читает ваши заметки, создает новые и поддерживает синхронизацию — и все это через API Team Relay.

Работает с Claude Code, Codex CLI, OpenCode и любым клиентом, совместимым с MCP.

Быстрый старт

1. Установка

Вариант А — из PyPI (рекомендуется):

Установка не требуется — uvx скачивает и запускает программу автоматически. Переходите к шагу 2.

Вариант Б — из исходного кода:

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

2. Настройка вашего ИИ-инструмента

Добавьте MCP-сервер в конфигурацию вашего инструмента, указав учетные данные Relay.

Добавьте в .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.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.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"
      }
    }
  }
}

Если вы установили программу из исходного кода, а не через PyPI, замените "command": "uvx" / "args": ["evc-team-relay-mcp"] на:

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

Готовые шаблоны конфигурации также находятся в папке config/.

3. Использование

Теперь у вашего ИИ-агента есть следующие инструменты:

Типичный рабочий процесс: list_shares -> list_files -> read_file / upsert_file

Аутентификация происходит автоматически — сервер выполняет вход и обновляет токены внутри системы.

Related MCP server: Obsidian Knowledge Management MCP Server

Удаленное развертывание (транспорт 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"
    }
  }
}

Безопасность

Этот MCP-сервер обладает значительными преимуществами в безопасности по сравнению с интеграциями на основе оболочки (shell):

• Отсутствие выполнения команд оболочки — все операции являются вызовами функций Python через JSON-RPC, что исключает риски инъекций команд

• Отсутствие аргументов CLI — учетные данные и токены никогда не передаются в качестве аргументов процесса (невидимы в выводе ps)

• Автоматическое управление токенами — сервер самостоятельно обрабатывает вход, обновление JWT и жизненный цикл токенов; агент никогда не взаимодействует с «сырыми» токенами

• Типизированные входные данные — все параметры проверяются на соответствие JSON Schema перед выполнением

• Единый постоянный процесс — нет запуска оболочки для каждого вызова, нет утечки переменных окружения между вызовами

Примечание: Если вы используете навык 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-сервер оборачивает REST API Team Relay в стандартные инструменты MCP. Team Relay хранит документы как Yjs CRDT и синхронизирует их с клиентами Obsidian в реальном времени. Изменения, внесенные агентом, мгновенно отображаются в Obsidian — и наоборот.

Предварительные требования

• Python 3.10+ с uv (рекомендуется) или pip

• Запущенный экземпляр EVC Team Relay (самостоятельно развернутый или хостинг)

• Учетная запись пользователя на панели управления Relay

Часть набора инструментов Entire VC

Сообщество

• entire.vc

• Обсуждения

• in@entire.vc

Лицензия

MIT