Skip to content

Add Oracle Database MCP Toolkit #98

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
Youssef-Erradi wants to merge 102 commits into
base: main
Choose a base branch
from
Open

Add Oracle Database MCP Toolkit #98

Youssef-Erradi wants to merge 102 commits into from

Conversation

@Youssef-Erradi
Copy link
Member

@Youssef-Erradi Youssef-Erradi commented Dec 15, 2025 •
edited
Loading

Description

Oracle Database MCP Toolkit is a Model Context Protocol (MCP) server that lets you:

  • Define your own custom tools via a simple YAML configuration file.
  • Use built-in tools:
    • Analyze Oracle JDBC thin client logs and RDBMS/SQLNet trace files.
    • Database-powered tools, including vector similarity search and SQL execution plan analysis.
  • Deploy locally or remotely - optionally as a container - with support for TLS and OAuth2

There's a demo of the MCP server available for testing, please check the DEMO.md file for instruction of how to use it.

Fixes #97 (Add Oracle Database MCP Toolkit)

Type of change

  • New feature (non-breaking change which adds functionality)

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have added tests that prove my fix is effective or that my feature works
  • Any dependent changes have been merged and published in downstream modules

Youssef-Erradi and others added 30 commits November 19, 2025 15:49
@Youssef-Erradi
Add OJDBC Log Analyzer MCP Server code
bdcff7d
@Youssef-Erradi
Add target and dependency-reduced-pom.xml to .gitignore
c470afd
@Youssef-Erradi
Fix package name
a4299fe
@Youssef-Erradi
Fix configuration for maven shade plugin
4ccc4a0
@Youssef-Erradi
Remove dependency-reduced-pom.xml from .gitignore file
4c9408f
@Youssef-Erradi
Add type to the provided JSON configuration
9e6d90b
@Youssef-Erradi
Add title to tools and fix their names
ceca78c
@Youssef-Erradi
Fix name and description of list-log-files-from-directory tool
ba21492
@aarrasseayoub01
Adding support for yaml config (custom tools and database connections)
f1f1969
@aarrasseayoub01
more refactoring
351d946
@aarrasseayoub01
Code refactoring
22a11bd
@MouhsinElmajdouby
Add http streamable transport method && update readme && enable tools…
340f3f8 
… system property
@aarrasseayoub01
Adding similarity search and explain/execute plan tools support. Addi…
de8196a 
…ng UCP.
@MouhsinElmajdouby
update jetty version to 12.1.1
ef02f18
@MouhsinElmajdouby
Merge remote-tracking branch 'origin/yaml-config' into yaml-config
a1a3843
@Youssef-Erradi
Rename OracleJDBCLogAnalyzerMCPServer class and test to OracleJDBCLog…
a3a2147 
…Analyzer
@Youssef-Erradi
Add oauth and web packages
1ea3202
@Youssef-Erradi
Fix OracleJDBCLogAnalyzer class name
1415e52
@Youssef-Erradi
Use JUL for logging
adf1d05
@Youssef-Erradi
hanlde NPE by logging info when YAML config file is not provided
9897a9b
@Youssef-Erradi
Add HTTP Authentication Configuration section and system properties
ba3605c
@Youssef-Erradi
Merge pull request #1
2460421 
- Add Yaml config support.
- Add HTTP streamable transport.
- Add Tools.
- Add support for HTTP authentication and OAuth 2 configuration.
@Youssef-Erradi
Remove LICENSE.txt file
abdcdee
@Youssef-Erradi
Remove THIRD_PARTY_LICENSES.txt file
e2bfe6d
@aarrasseayoub01
Adding support for env variables within yaml file
fdaeec5
@MouhsinElmajdouby
Add Dockerfile and container usage documentation
4c34fb2
@MouhsinElmajdouby
Update json with bash tags in readme
3501993
@aarrasseayoub01
Updating list of tools
28a6967
@aarrasseayoub01
updating readme
8087b9f
@MouhsinElmajdouby
Remove EXPOSE 45450 from Dockerfile
7c5fa26
jeandelavarene and others added 21 commits December 10, 2025 18:35
@jeandelavarene
Add license
7352926
@aarrasseayoub01
Adding license.txt and changing "source" to "dataSource"
6a0c87f
@aarrasseayoub01
Merge pull request #14 from Youssef-Erradi/refactoring
ee2b8c8 
Adding license.txt and changing "source" to "dataSource"
@jeandelavarene
Renaming toolbox to toolkit
befbd2c
@jeandelavarene
Merge remote-tracking branch 'origin/oracle-db-toolbox-mcp-server' in…
179bb26 
…to oracle-db-toolbox-mcp-server
@jeandelavarene
Renaming toolbox to toolkit
4ff52ae
@aarrasseayoub01
Updating readme with datasource
edf3c30
@aarrasseayoub01
Merge pull request #15 from Youssef-Erradi/refactoring
bca223b 
Updating readme with datasource
@aarrasseayoub01
Making fields private and using getters instead
38b46f5
@aarrasseayoub01
Adding javadoc for enableHttps method
04bc415
@jeandelavarene
Merge pull request #16 from Youssef-Erradi/refactoring
e051448 
Refactoring
@MouhsinElmajdouby
Clarify README wording for vault-based providers
8365d65
@aarrasseayoub01
Adding javadoc for enableHttps method
2de9d4d
@aarrasseayoub01
Using char[] for passwords instead of String
64e6ed0 
# Conflicts:
#	src/oracle-db-mcp-toolkit/src/main/java/com/oracle/database/mcptoolkit/config/DataSourceConfig.java
@aarrasseayoub01
Add password method as a workaround for the necessity of leaving pass…
53a5aca 
…word as a string
@aarrasseayoub01
Fixing conflicts and making fields public again for yaml parsing
894e38d
@aarrasseayoub01
.
beb3652
@aarrasseayoub01
Merge pull request #18 from Youssef-Erradi/docs-clarify-ojdbc-ext-dir…
c78b0e0 
…-vault-config

Docs clarify ojdbc ext dir vault config
@aarrasseayoub01
Adding DEMO.md
4e4228b
@aarrasseayoub01
Merge pull request #19 from Youssef-Erradi/demo
3a8fa96 
Adding DEMO.md
@Youssef-Erradi
Merge branch 'oracle:main' into oracle-db-mcp-toolkit
7317213
@oracle-contributor-agreement oracle-contributor-agreement bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Dec 15, 2025
@jeandelavarene
Copy link
Member

jeandelavarene commented Dec 23, 2025

Hi @Youssef-Erradi, can you please make the following changes to the PR:

  • Remove http support (keep https only)
  • In the README, under "Enabling HTTPS (SSL/TLS)" add a warning message that says "WARNING: enable https at your own risk. When enabling https pay extra attention to the MCP tools that you enable as they may create a new risk for your database server."
  • At the beginning of the README, at the end of the first paragraph "1. Overview", add this: "Note the Oracle SQLcl Model Context Protocol (MCP) Server (add a link) is a fully supported product with MCP capabilities for the Oracle Database."
  • rename the directory from "oracle-db-mcp-toolkit" to "oracle-db-mcp-java-toolkit"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

1 more reviewer

@jeandelavarene jeandelavarene jeandelavarene approved these changes

Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Add Oracle Database MCP Toolkit

4 participants

@Youssef-Erradi @jeandelavarene @aarrasseayoub01 @MouhsinElmajdouby