Registrar un Servidor MCP

Los servidores MCP (Model Context Protocol) extienden tu asistente de IA con herramientas externas. RaiSE gestiona el registro, la configuración y la verificación de salud de servidores a través del grupo de comandos rai mcp.

Dos Métodos de Registro

Método 1: Instalar un Paquete

Para servidores MCP publicados, usa rai mcp install:

# Paquete npx (Node.js)
rai mcp install "@upstash/context7-mcp" --type npx --name context7

# Paquete uvx (Python)
rai mcp install "semgrep-mcp" --type uvx --name semgrep --env SEMGREP_APP_TOKEN

# Paquete pip (módulo Python)
rai mcp install "mcp-server-fetch" --type pip --name fetch --module mcp_server_fetch

Método 2: Scaffolding Manual

Para servidores personalizados o locales, usa rai mcp scaffold:

rai mcp scaffold my-server \
  --command "node" \
  --args "path/to/server.js" \
  --env "MY_API_KEY"

Formato del Archivo de Configuración

Ambos métodos crean una configuración YAML en .raise/mcp/. El formato del catálogo:

# .raise/mcp/catalog.yaml
servers:
  context7:
    package: "@upstash/context7-mcp"
    type: npx
    description: "Consultas de documentación para cualquier librería vía Context7"
    recommended_for: all

  github:
    package: "@modelcontextprotocol/server-github"
    type: npx
    env: [GITHUB_TOKEN]
    description: "Operaciones de repositorio GitHub"
    recommended_for: all

  semgrep:
    package: "semgrep-mcp"
    type: uvx
    env: [SEMGREP_APP_TOKEN]
    description: "SAST + SCA + detección de secretos"
    recommended_for: all

Campos de configuración: - package — Identificador del paquete para instalación - type — npx, uvx o pip - module — Nombre del módulo Python (solo pip) - env — Nombres de variables de entorno requeridas - description — Propósito en lenguaje humano - recommended_for — Lista de lenguajes, o all para universal

Verificación

Tras el registro, verifica que tu servidor funciona:

# Listar servidores registrados
rai mcp list

# Verificar salud del servidor
rai mcp health context7

# Listar herramientas disponibles en un servidor
rai mcp tools context7

# Llamar a una herramienta específica
rai mcp call context7 resolve-library-id --args '{"libraryName": "react"}'

Ejemplo: Registrar Context7

Context7 proporciona consultas de documentación para cualquier librería. Aquí está el flujo completo:

# Instalar
rai mcp install "@upstash/context7-mcp" --type npx --name context7

# Verificar
rai mcp health context7
rai mcp tools context7

No se necesitan variables de entorno. El servidor está disponible inmediatamente para tu asistente de IA para consultas de documentación.