The `mcp-oracle-database` package provides a Model Context Protocol (MCP) server specifically designed to enable AI assistants, such as GitHub Copilot, to execute read-only SQL queries against Oracle databases. Currently at version `1.0.0`, it offers a stable initial release. While no explicit release cadence is stated, its design as a crucial bridge for LLM-driven database interactions suggests ongoing maintenance. Key differentiators include its strict read-only access model for enhanced security, direct standard input/output (stdio) transport for communication (eliminating the need for an HTTP server), efficient Oracle connection pooling, and capabilities for schema introspection. It also features audit logging for all executed queries, timeout protection for long-running operations, and configurable row limits to prevent excessive memory usage. Notably, it leverages `node-oracledb` in Thin Mode, which means developers do not need to install the Oracle Instant Client, simplifying deployment and setup compared to traditional Oracle database drivers.
npm install mcp-oracle-databaseVerified import paths — ran on the pinned version, not inferred.
Demonstrates how to programmatically spawn and monitor the MCP Oracle Database server process using TypeScript, mimicking its execution via a VS Code MCP client configuration. It shows how environment variables configure database connection details and how to capture server output.
No action required. The package handles Oracle connectivity purely in JavaScript. Ensure you have Node.js v18 or higher.
Always create a specific Oracle user with only `CONNECT` and `SELECT` privileges on the necessary tables/schemas. Regularly audit user privileges and avoid using administrator or write-enabled accounts for the server.
Double-check all Oracle-related environment variables for typos, correct host/port/service name, and valid credentials. Ensure the Oracle database is running and accessible from the server's host machine. Consult your Oracle DBA for connection string specifics.
Configure `QUERY_TIMEOUT_MS` and `MAX_ROWS_PER_QUERY` to reasonable, conservative values that align with typical query expectations and available server resources. Start with lower values and increase only if necessary, monitoring performance.
If installed globally: Ensure `npm install -g mcp-oracle-database` was successful and your PATH includes npm's global bin directory. If installed locally: Ensure `npm install mcp-oracle-database` was run and you are invoking the command correctly, e.g., via `npx mcp-database-server` or by specifying the full path `node_modules/.bin/mcp-database-server`.
Verify that the `ORACLE_CONNECTION_STRING` environment variable is correct (hostname, port, service name/SID). Ensure the Oracle database instance is running and is accessible from the machine hosting the MCP server (check network connectivity and firewall rules).
Confirm that `ORACLE_USER` and `ORACLE_PASSWORD` environment variables contain the correct credentials for your read-only Oracle user. Ensure the user has `CONNECT` privilege on the database.
No dependency data recorded yet.