MCP Oracle Server

Um servidor que fornece ferramentas para interagir com um banco de dados Oracle.

Documentação

MCP Oracle Server

Este projeto é um servidor Node.js que expõe ferramentas para interagir com um banco de dados Oracle através do protocolo Model Context Protocol (MCP). Permite executar consultas SELECT, descrever tabelas e listar tabelas disponíveis no banco de dados Oracle de forma segura e controlada.

Para que serve?

Executar consultas SELECT em um banco de dados Oracle.
Descrever a estrutura de qualquer tabela Oracle.
Listar todas as tabelas disponíveis para o usuário conectado.
Facilita a integração de bancos de dados Oracle com ferramentas que suportam MCP.

Requisitos

Node.js >= 18
Acesso a um banco de dados Oracle
Ter configuradas as variáveis de ambiente para a conexão Oracle:
- ORACLE_USER
- ORACLE_PASSWORD
- ORACLE_HOST
- ORACLE_PORT
- ORACLE_DATABASE

Instalação

Clone o repositório:

git clone https://github.com/YrsonHTM/mcp-oracle-server.git
cd mcp-oracle-server

Instale as dependências:
```
npm install
```

Uso

Iniciar o servidor

npm start

O servidor será executado e estará pronto para receber comandos MCP via stdio.

Ferramentas disponíveis

execute_query: Executa uma consulta SELECT no Oracle.
describe_table: Descreve a estrutura de uma tabela.
list_tables: Lista todas as tabelas disponíveis para o usuário.

Exemplo de uso no Cursor

Você pode integrar este servidor com Cursor para interagir com seu banco de dados Oracle diretamente da interface do Cursor.

1. Configure o arquivo `mcp.json`

Crie (ou edite) o arquivo mcp.json no caminho c:\Users\<TU_USUARIO>\.cursor\mcp.json (no Windows) ou ~/.cursor/mcp.json (no Linux/Mac). Exemplo de configuração:

{
  "mcpServers": {
    "oracle-db": {
      "command": "node",
      "args": ["RUTA_DONDE_INSTALA_EL_SERVER: EJ: C:\\mcp-oracle-server\\server.js"],
      "env": {
        "ORACLE_HOST": "HOST_SERVER: EJ:10.10.10.10",
        "ORACLE_PORT": "PRT: EJ:1521",
        "ORACLE_DATABASE": "NOMBRE_BASE_DATOS: EJ:pruebadb",
        "ORACLE_USER": "NOMBRE_USUARIO: EJ:admin",
        "ORACLE_PASSWORD": "CONTRASEÑAñ EJ:1234"
      }
    }
  }
}

Altere os caminhos e credenciais de acordo com seu ambiente e banco de dados.
Certifique-se de que o caminho para server.js esteja correto.

2. Adicione o servidor MCP no Cursor

Abra o Cursor.
Vá para a configuração de MCP (Model Context Protocol).
Clique em "Adicionar servidor MCP" e selecione o nome que você configurou (por exemplo, oracle-db).
Inicie o servidor pelo Cursor ou manualmente com npm start.

3. Use as ferramentas pelo Cursor

Agora você pode executar consultas, descrever tabelas e listar tabelas diretamente pela interface do Cursor usando o servidor MCP que você configurou.

Notas

O servidor só permite consultas SELECT para evitar modificações acidentais no banco de dados.
Se você tiver problemas com a conexão Oracle, verifique se as variáveis de ambiente estão configuradas corretamente.

Licença

MIT

MCP Oracle Server

Documentação