EVC Team Relay - Servidor MCP

Dale a tu agente de IA acceso de lectura/escritura a tu Obsidian vault.

Tu agente lee tus notas, crea otras nuevas y se mantiene sincronizado, todo a través de la API de Team Relay.

Funciona con Claude Code, Codex CLI, OpenCode y cualquier cliente compatible con MCP.

Inicio rápido

1. Instalación

Opción A — desde PyPI (recomendado):

No se necesita instalación: uvx descarga y ejecuta automáticamente. Pasa al paso 2.

Opción B — desde el código fuente:

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

2. Configura tu herramienta de IA

Agrega el servidor MCP a la configuración de tu herramienta con tus credenciales de Relay.

Agrega a .mcp.json en la raíz de tu proyecto o en ~/.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"
      }
    }
  }
}

Agrega a tu 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"
      }
    }
  }
}

Agrega a 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"
      }
    }
  }
}

Si instalaste desde el código fuente en lugar de PyPI, reemplaza "command": "uvx" / "args": ["evc-team-relay-mcp"] con:

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

Las plantillas de configuración listas para copiar también se encuentran en config/.

3. Úsalo

Tu agente de IA ahora tiene estas herramientas:

Flujo de trabajo típico: list_shares -> list_files -> read_file / upsert_file

La autenticación es automática: el servidor inicia sesión y actualiza los tokens internamente.

Related MCP server: Obsidian Knowledge Management MCP Server

Despliegue remoto (Transporte HTTP)

Para despliegues compartidos o del lado del servidor, ejecútalo como un servidor 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

Luego configura tu cliente MCP para conectarse a través de HTTP:

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

Seguridad

El servidor MCP proporciona ventajas de seguridad significativas sobre las integraciones basadas en shell:

• Sin ejecución de shell: todas las operaciones son llamadas a funciones de Python a través de JSON-RPC, eliminando los riesgos de inyección de comandos

• Sin argumentos CLI: las credenciales y los tokens nunca se pasan como argumentos de proceso (invisibles en la salida de ps)

• Gestión automática de tokens: el servidor maneja el inicio de sesión, la actualización de JWT y el ciclo de vida del token internamente; el agente nunca toca los tokens sin procesar

• Entradas tipadas: todos los parámetros se validan contra el esquema JSON antes de la ejecución

• Proceso persistente único: sin generación de shell por llamada, sin fugas de entorno entre invocaciones

Nota: Si estás utilizando la habilidad OpenClaw (scripts bash), considera migrar a este servidor MCP para una integración más segura y fácil de mantener.

Cómo funciona

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

El servidor MCP envuelve la API REST de Team Relay en herramientas MCP estándar. Team Relay almacena documentos como CRDTs de Yjs y los sincroniza con los clientes de Obsidian en tiempo real. Los cambios realizados por el agente aparecen en Obsidian al instante, y viceversa.

Requisitos previos

• Python 3.10+ con uv (recomendado) o pip

• Una instancia de EVC Team Relay en ejecución (autoalojada o alojada)

• Una cuenta de usuario en el plano de control de Relay

Parte de la caja de herramientas de Entire VC

Comunidad

• entire.vc

• Discusiones

• in@entire.vc

Licencia

MIT