Open Enthrium

Servidor MCP para Claude Code, Cursor, Windsurf y otros clientes MCP. Conecta asistentes de IA a PostgreSQL, sistemas de archivos, GitHub, Slack, SSH, etc.

Documentación

Open Enthrium AI MCP Server

Servidor MCP Empresarial · Apache-2.0 · Claude Code · Cursor · Windsurf · Codex · Claude Desktop · VS Code

Conecta cualquier asistente de codificación con IA a los datos de tu empresa — bases de datos, archivos, APIs y más — mediante un único binario.

License: Apache 2.0 GitHub Release Windows Linux macOS npm Website


¿Qué es OE MCP Server?

Un binario independiente que implementa el Protocolo de Contexto de Modelo (MCP) y expone las fuentes de datos de tu empresa como herramientas que las aplicaciones de IA pueden usar directamente. Sin código. Define conectores en un único archivo JSON.

  • Más de 45 categorías de conectores — PostgreSQL, MongoDB, S3, GitHub, Slack, Gmail, SSH, API REST y más
  • Dos modos de transporte — --stdio para Claude Code / Cursor / Windsurf; --serve para implementaciones en la nube o en equipo
  • Memoria persistente — memory_set / memory_get / memory_list / memory_delete sobreviven entre sesiones
  • Registro de acciones — cada llamada de conector se registra automáticamente con marca de tiempo, herramienta, entrada y resultado
  • Ejecuta agentes de IA — run_agent ejecuta cualquier agente SKILL.md de OE Runtime directamente desde Claude Code, Cursor o cualquier cliente MCP. Las habilidades manuales se pausan para aprobación mediante approve_chain.
  • Autoalojado — se ejecuta en tu propia máquina, sin dependencia de la nube, sin llamadas de retorno

Inicio rápido mediante npm (Recomendado)

1. Crea oe-mcp.json:

{
  "connectors": [
    {
      "name": "my-postgres",
      "type": "postgresql",
      "host": "localhost",
      "port": 5432,
      "database": "mydb",
      "user": "postgres",
      "password": "secret"
    },
    {
      "name": "my-codebase",
      "type": "filesystem",
      "basePath": "/home/user/projects/myapp"
    }
  ],
  "memory": [
    { "key": "project_context", "value": "This is our main application." }
  ]
}

2. Añádelo a la configuración MCP de tu aplicación de IA:

macOS / Linux:

{
  "mcpServers": {
    "oe-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@openenthrium/oe-mcp", "--stdio", "/path/to/oe-mcp.json"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "oe-mcp": {
      "type": "stdio",
      "command": "npx.cmd",
      "args": ["-y", "@openenthrium/oe-mcp", "--stdio", "C:\\path\\to\\oe-mcp.json"]
    }
  }
}

-y es obligatorio — sin él, npx bloquea esperando entrada de teclado y la conexión MCP nunca se abre.

3. Recarga tu aplicación de IA — los conectores aparecen como herramientas automáticamente.

Pregunta a Claude: "¿A qué conectores tienes acceso?" para verificar.


Descarga (Binario independiente)

PlataformaBinario
Windowsoe-mcp-win.exe
Linuxoe-mcp-linux
macOSoe-mcp-macos
Configuraciones de ejemplooe-mcp-samples.zip

Herramientas integradas

Memoria

Memoria persistente que sobrevive a los reinicios — almacenada en oe-mcp-memory.json:

HerramientaDescripción
memory_setAlmacena un par clave-valor entre sesiones
memory_getRecupera un valor almacenado por clave
memory_listLista todos los pares clave-valor almacenados
memory_deleteElimina una clave almacenada

"Recuerda que nuestra base de datos de producción está en prod-db.company.com" → Claude llama a memory_set

Registro de acciones

Cada llamada de conector se registra automáticamente en oe-mcp-log.json:

HerramientaDescripción
log_listLista las llamadas de conector recientes (más recientes primero, admite limit)
log_clearBorra todas las entradas del registro

Ejecutar agentes de IA

Ejecuta agentes SKILL.md de OE Runtime o agentes YAML directamente desde Claude Code, Cursor o cualquier cliente MCP — sin necesidad de terminal:

HerramientaDescripción
run_agentEjecuta un agente por ruta de archivo. Las habilidades automáticas se ejecutan de inmediato; las habilidades manuales se pausan y devuelven pending_skill_chain.
list_pending_skillsLista todas las habilidades manuales actualmente pausadas y en espera de aprobación
approve_chainAprueba, omite o aborta una habilidad manual pausada mediante chain_id

Parámetros de run_agent:

ParámetroObligatorioDescripción
file✅Ruta absoluta a agent.yaml
params❌Pares clave-valor sustituidos mediante {{key}} en el agente
input❌Mensaje inicial opcional pasado al agente

Parámetros de approve_chain:

ParámetroObligatorioDescripción
chain_id✅De pending_skill_chain.chain_id en una respuesta de run_agent
approved❌true para ejecutar la habilidad (predeterminado), false para omitirla y continuar
abort❌true para detener todo el pipeline inmediatamente

OE MCP busca oe-config.json en el directorio del agente primero, y luego recurre a oe-mcp.json.

Flujo de aprobación de habilidades del agente

Cuando el pipeline de habilidades de un agente incluye habilidades manuales, Claude gestiona el bucle de aprobación automáticamente:

  1. Claude llama a run_agent → la respuesta muestra ⏸ Skill awaiting approval con chain_id y skill_name
  2. Claude decide — según tus instrucciones — si aprobar, omitir o abortar
  3. Claude llama a approve_chain → la siguiente habilidad se ejecuta o la siguiente habilidad manual se pausa de nuevo
  4. Repite hasta Pipeline complete o hasta que Claude aborte

Ejemplo de instrucción para Claude Code: "Ejecuta el orquestador de OE Skills y envía un mensaje de Slack — omite cualquier cosa que no puedas hacer, aborta si pide credenciales."


Modos de transporte

ModoIndicadorIdeal para
stdio--stdioClaude Code, Cursor, Windsurf, Codex, Claude Desktop — iniciado como proceso hijo
HTTP--serve --port 4040Implementaciones en la nube, compartir un servidor entre un equipo

Modo HTTP — inicia el servidor y luego añade la URL a Cursor / Windsurf / Claude Desktop:

oe-mcp-linux --serve --port 4040 /path/to/oe-mcp.json
# → http://your-server.com:4040/mcp

Configuraciones de ejemplo

Descarga oe-mcp-samples.zip — oe-mcp.json listas para usar para conectores comunes:

postgres · mysql · mongodb · github · slack · gdrive · ssh · filesystem · oracle · salesforce · servicenow · telegram · notion · confluence · graphql · zoho-mail · sftp · dropbox · multi-connector


Parte de Open Enthrium

⚡ Runtime de agentesopen-enthrium-ai-agent-runtime — ejecuta agentes SKILL.md como CLI o servidor HTTP
🖥️ Plataformaopen-enthrium-ai-platform — aplicación web completa con espacios de trabajo, RAG, Constructor de agentes
🌐 Sitio webopenenthrium.com

Contribuciones

→ Consulta CONTRIBUTING.md para saber cómo añadir configuraciones de ejemplo y adaptadores de conectores.


Licencia

Apache-2.0 — libre de usar, modificar e implementar para cualquier propósito, incluido el uso comercial. Sin límites de uso. Sin telemetría. Sin llamadas de retorno.