EVC Team Relay - MCP-Server

Gib deinem KI-Agenten Lese-/Schreibzugriff auf deinen Obsidian-Vault.

Dein Agent liest deine Notizen, erstellt neue und bleibt synchronisiert — alles über die Team Relay API.

Funktioniert mit Claude Code, Codex CLI, OpenCode und jedem MCP-kompatiblen Client.

Schnellstart

1. Installation

Option A — über PyPI (empfohlen):

Keine Installation erforderlich — uvx lädt das Programm automatisch herunter und führt es aus. Fahre mit Schritt 2 fort.

Option B — aus dem Quellcode:

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

2. Konfiguriere dein KI-Tool

Füge den MCP-Server mit deinen Relay-Zugangsdaten zur Konfiguration deines Tools hinzu.

Füge dies zur .mcp.json in deinem Projektstammverzeichnis oder ~/.claude/.mcp.json hinzu:

{
  "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"
      }
    }
  }
}

Füge dies zu deiner codex.json hinzu:

{
  "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"
      }
    }
  }
}

Füge dies zu opencode.json hinzu:

{
  "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"
      }
    }
  }
}

Wenn du aus dem Quellcode statt über PyPI installiert hast, ersetze "command": "uvx" / "args": ["evc-team-relay-mcp"] durch:

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

Konfigurationsvorlagen zum Kopieren findest du auch in config/.

3. Verwendung

Dein KI-Agent verfügt nun über diese Tools:

Typischer Arbeitsablauf: list_shares -> list_files -> read_file / upsert_file

Die Authentifizierung erfolgt automatisch — der Server meldet sich an und aktualisiert Tokens intern.

Related MCP server: Obsidian Knowledge Management MCP Server

Remote-Bereitstellung (HTTP-Transport)

Für freigegebene oder serverseitige Bereitstellungen als HTTP-Server ausführen:

# 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

Konfiguriere dann deinen MCP-Client für die Verbindung über HTTP:

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

Sicherheit

Der MCP-Server bietet erhebliche Sicherheitsvorteile gegenüber Shell-basierten Integrationen:

• Keine Shell-Ausführung — alle Operationen sind Python-Funktionsaufrufe via JSON-RPC, was das Risiko von Command-Injection eliminiert

• Keine CLI-Argumente — Zugangsdaten und Tokens werden niemals als Prozessargumente übergeben (unsichtbar in der ps-Ausgabe)

• Automatische Token-Verwaltung — der Server übernimmt intern die Anmeldung, JWT-Aktualisierung und den Token-Lebenszyklus; der Agent kommt nie mit Roh-Tokens in Berührung

• Typisierte Eingaben — alle Parameter werden vor der Ausführung gegen ein JSON-Schema validiert

• Einzelner persistenter Prozess — kein Shell-Spawning pro Aufruf, keine Umgebungsvariablen-Lecks zwischen Aufrufen

Hinweis: Wenn du das OpenClaw-Skill (Bash-Skripte) verwendest, erwäge den Umstieg auf diesen MCP-Server für eine sicherere und wartbarere Integration.

Funktionsweise

┌─────────────┐      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         └──────────────┘

Der MCP-Server kapselt die REST-API von Team Relay in Standard-MCP-Tools. Team Relay speichert Dokumente als Yjs CRDTs und synchronisiert sie in Echtzeit mit Obsidian-Clients. Änderungen durch den Agenten erscheinen sofort in Obsidian — und umgekehrt.

Voraussetzungen

• Python 3.10+ mit uv (empfohlen) oder pip

• Eine laufende EVC Team Relay-Instanz (selbst gehostet oder gehostet)

• Ein Benutzerkonto auf der Relay-Steuerungsebene

Teil der Entire VC Toolbox

Community

• entire.vc

• Diskussionen

• in@entire.vc

Lizenz

MIT