Hala.DatabaseAgent.OracleMcpServer 1.0.16

dotnet tool install --global Hala.DatabaseAgent.OracleMcpServer --version 1.0.16
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local Hala.DatabaseAgent.OracleMcpServer --version 1.0.16
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Hala.DatabaseAgent.OracleMcpServer&version=1.0.16
                    
nuke :add-package Hala.DatabaseAgent.OracleMcpServer --version 1.0.16
                    

Oracle Database MCP Agent

Oracle Database MCP Agent with 30+ tools for AI-powered database analysis.

VS Code Integration

Add to your VS Code MCP settings to automatically install and configure:

{
  "servers": {
    "oracle-agent-server": {
      "command": "dnx",
      "args": ["Hala.DatabaseAgent.OracleMcpServer", "--version", "1.0.16", "--yes"],
      "env": {
        "OracleConnectionString": "your-oracle-connection-string",
        "LogFilePath": "log-file-directory"
      }
    }
  }
}

The dnx command will automatically download and install the package when VS Code starts the MCP server.

⚡ Configuration

Set your Oracle connection string in the environment variables:

Note: The .NET 10 SDK is required as a prerequisite to use this package, to make use of dnx command.
For setup and usage details, refer to the official blog:
Download .NET 10.0 The initial startup of the MCP server may take some time, as it caches important metadata about the database objects.

Required:

  • OracleConnectionString - Your Oracle database connection string

🔍 Example Connection Strings

# Standard Oracle connection
Host=localhost;Port=1521;Database=ORCL;User Id=hr;Password=password;

# Oracle with TNS
Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=server)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service)));User Id=user;Password=pass;

� Manual Installation (Optional)

If you prefer to install manually:

dotnet tool install -g Hala.DatabaseAgent.OracleMcpServer --version 1.0.16

Then run directly: oracle-mcp-server

�📚 Documentation

🎯 Features

  • 30+ MCP Tools for database analysis
  • Metadata Discovery - Tables, views, procedures, functions
  • Dependency Analysis - Impact analysis before schema changes
  • Performance Tools - Performance analysis, index analysis and optimization
  • AI Integration - Seamless integration with AI assistants

📋 Requirements

  • .NET 8.0+
  • Oracle Database 11g R2+
  • Network access to Oracle database

⚠️ Disclaimer

This software is provided "as-is" without any warranties or guarantees. The authors and contributors are not responsible for any data loss, corruption, or other impacts resulting from the use of this package. Use it at your own risk.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.0.16 326 7/25/2025
1.0.15 322 7/25/2025
1.0.14 485 7/23/2025
1.0.13 476 7/22/2025
1.0.12-preview 428 7/21/2025
1.0.11-preview 431 7/21/2025
1.0.3 476 7/22/2025
1.0.2 433 7/21/2025

Version 1.0.16: Performance optimizations with fast boot capabilities. Enhanced metadata caching, improved connection handling, and better error recovery. Includes comprehensive GitHub Actions CI/CD pipeline for automated releases.