Open Enthrium

---

O que é o OE MCP Server?

Um binário autônomo que implementa o Model Context Protocol (MCP) e expõe suas fontes de dados empresariais como ferramentas que aplicativos de IA podem usar diretamente. Sem código. Defina conectores em um único arquivo JSON.

• Mais de 45 categorias de conectores — PostgreSQL, MongoDB, S3, GitHub, Slack, Gmail, SSH, API REST e muito mais
• Dois modos de transporte — --stdio para Claude Code / Cursor / Windsurf; --serve para implantações em nuvem ou em equipe
• Memória persistente — memory_set / memory_get / memory_list / memory_delete sobrevivem entre sessões
• Registro de ações — cada chamada de conector é registrada automaticamente com carimbo de data/hora, ferramenta, entrada e resultado
• Execute agentes de IA — run_agent executa qualquer agente OE Runtime SKILL.md diretamente do Claude Code, Cursor ou qualquer cliente MCP. Habilidades manuais pausam para aprovação via approve_chain.
• Auto-hospedado — roda na sua própria máquina, sem dependência de nuvem, sem chamadas de retorno

---

Início Rápido via npm (Recomendado)

1. Crie 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. Adicione à configuração MCP do seu aplicativo 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 é obrigatório — sem ele, o npx bloqueia aguardando entrada do teclado e a conexão MCP nunca é aberta.

3. Recarregue seu aplicativo de IA — os conectores aparecem como ferramentas automaticamente.

Pergunte ao Claude: "Quais conectores você tem acesso?" para verificar.

---

Download (Binário Autônomo)

Plataforma	Binário
Windows	oe-mcp-win.exe
Linux	oe-mcp-linux
macOS	oe-mcp-macos
Configurações de exemplo	oe-mcp-samples.zip

---

Ferramentas Integradas

Memória

Memória persistente que sobrevive a reinicializações — armazenada em oe-mcp-memory.json:

Ferramenta	Descrição
memory_set	Armazena um par chave-valor entre sessões
memory_get	Recupera um valor armazenado pela chave
memory_list	Lista todos os pares chave-valor armazenados
memory_delete	Remove uma chave armazenada

"Lembre-se de que nosso banco de dados de produção está em prod-db.company.com" → Claude chama memory_set

Registro de Ações

Cada chamada de conector é registrada automaticamente em oe-mcp-log.json:

Ferramenta	Descrição
log_list	Lista chamadas recentes de conectores (mais recentes primeiro, suporta limit)
log_clear	Limpa todas as entradas do registro

Executar Agentes de IA

Execute agentes OE Runtime SKILL.md ou agentes YAML diretamente do Claude Code, Cursor ou qualquer cliente MCP — sem necessidade de terminal:

Ferramenta	Descrição
run_agent	Executa um agente por caminho de arquivo. Habilidades automáticas executam imediatamente; habilidades manuais pausam e retornam pending_skill_chain.
list_pending_skills	Lista todas as habilidades manuais atualmente pausadas aguardando aprovação
approve_chain	Aprova, pula ou aborta uma habilidade manual pausada por chain_id

Parâmetros de run_agent:

Parâmetro	Obrigatório	Descrição
file	✅	Caminho absoluto para agent.yaml
params	❌	Pares chave-valor substituídos via {{key}} no agente
input	❌	Mensagem inicial opcional passada ao agente

Parâmetros de approve_chain:

Parâmetro	Obrigatório	Descrição
chain_id	✅	De pending_skill_chain.chain_id em uma resposta run_agent
approved	❌	true para executar a habilidade (padrão), false para pulá-la e continuar
abort	❌	true para interromper todo o pipeline imediatamente

O OE MCP procura por oe-config.json no diretório do agente primeiro e, em seguida, recorre a oe-mcp.json.

Fluxo de Aprovação de Habilidades do Agente

Quando o pipeline de habilidades de um agente inclui habilidades manuais, o Claude lida com o loop de aprovação automaticamente:

1. Claude chama run_agent → a resposta mostra ⏸ Skill awaiting approval com chain_id e skill_name
2. Claude decide — com base nas suas instruções — se aprova, pula ou aborta
3. Claude chama approve_chain → a próxima habilidade é executada ou a próxima habilidade manual pausa novamente
4. Repita até Pipeline complete ou Claude abortar

Exemplo de instrução para o Claude Code: "Execute o orquestrador de habilidades OE e envie uma mensagem no Slack — pule o que não puder fazer, aborte se pedir credenciais."

---

Modos de Transporte

Modo	Flag	Melhor para
stdio	--stdio	Claude Code, Cursor, Windsurf, Codex, Claude Desktop — iniciado como processo filho
HTTP	--serve --port 4040	Implantações em nuvem, compartilhamento de um servidor entre uma equipe

Modo HTTP — inicie o servidor e adicione a URL ao Cursor / Windsurf / Claude Desktop:

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

---

Configurações de Exemplo

Baixe oe-mcp-samples.zip — oe-mcp.json prontos para uso para conectores comuns:

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

---

Parte do Open Enthrium

⚡ Agent Runtime	open-enthrium-ai-agent-runtime — execute agentes SKILL.md como CLI ou servidor HTTP
🖥️ Plataforma	open-enthrium-ai-platform — aplicativo web completo com workspaces, RAG, Agent Builder
🌐 Site	openenthrium.com

---

Contribuindo

→ Veja CONTRIBUTING.md para saber como adicionar configurações de exemplo e adaptadores de conectores.

---

Licença

Apache-2.0 — livre para usar, modificar e implantar para qualquer finalidade, incluindo uso comercial. Sem limites de uso. Sem telemetria. Sem chamadas de retorno.

---