Skip to content

Commit e287a1b

Browse files
shyam2511shyam2511
committed
Database MCP Server
1 parent 8fd532b commit e287a1b

File tree

10 files changed

+14408
-0
lines changed

10 files changed

+14408
-0
lines changed

‎src/database-mcp-server/LICENSE.txt‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Copyright (c) 2025 Oracle and/or its affiliates.
2+
3+
The Universal Permissive License (UPL), Version 1.0
4+
5+
Subject to the condition set forth below, permission is hereby granted to any
6+
person obtaining a copy of this software, associated documentation and/or data
7+
(collectively the "Software"), free of charge and under any and all copyright
8+
rights in the Software, and any and all patent rights owned or freely
9+
licensable by each licensor hereunder covering either (i) the unmodified
10+
Software as contributed to or provided by such licensor, or (ii) the Larger
11+
Works (as defined below), to deal in both
12+
13+
(a) the Software, and
14+
(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
15+
one is included with the Software (each a "Larger Work" to which the Software
16+
is contributed by such licensors),
17+
18+
without restriction, including without limitation the rights to copy, create
19+
derivative works of, display, perform, and distribute the Software and make,
20+
use, sell, offer for sale, import, export, have made, and have sold the
21+
Software and the Larger Work(s), and to sublicense the foregoing rights on
22+
either these or other terms.
23+
24+
This license is subject to the following condition:
25+
The above copyright notice and either this complete permission notice or at
26+
a minimum a reference to the UPL must be included in all copies or
27+
substantial portions of the Software.
28+
29+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
31+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
32+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
33+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
34+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
35+
SOFTWARE.

‎src/database-mcp-server/README.md‎

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
# OCI Database MCP Server
2+
3+
## Overview
4+
5+
This server provides tools to interact with the OCI Database service.
6+
7+
## Running the server
8+
9+
```sh
10+
uv run oracle.database-mcp-server
11+
```
12+
13+
## Tools
14+
15+
| Tool Name | Description|
16+
| --- | --- |
17+
| list_application_vips | Get application virtual IP (VIP) addresses on a cloud VM cluster|
18+
| list_autonomous_container_database_dataguard_associations | List Autonomous Data Guard associations for an Autonomous Container Database|
19+
| list_autonomous_container_database_versions | List supported Autonomous Container Database versions|
20+
| list_autonomous_container_databases | List Autonomous Container Databases in a compartment|
21+
| list_autonomous_database_backups | List Autonomous Database backups by database ID or compartment|
22+
| list_autonomous_database_character_sets | List supported character sets for Autonomous Databases|
23+
| list_autonomous_database_clones | List clones for a specific Autonomous Database|
24+
| list_autonomous_database_dataguard_associations | List Autonomous Data Guard associations for an Autonomous Database|
25+
| list_autonomous_database_peers | List peers for a specific Autonomous Database|
26+
| list_autonomous_database_refreshable_clones | List refreshable clones for a specific Autonomous Database|
27+
| list_autonomous_database_software_images | List Autonomous Database Software Images in a compartment|
28+
| list_autonomous_databases | List Autonomous Databases in a compartment|
29+
| list_autonomous_db_preview_versions | List supported preview versions for Autonomous Databases|
30+
| list_autonomous_db_versions | List supported versions for Autonomous Databases|
31+
| list_autonomous_virtual_machines | List Autonomous Virtual Machines in a specified cluster and compartment|
32+
| list_autonomous_vm_clusters | List Exadata Cloud@Customer Autonomous VM clusters in a compartment|
33+
| list_backup_destination | List backup destinations in a compartment|
34+
| list_backups | List database backups by database ID or compartment|
35+
| list_cloud_autonomous_vm_clusters | List Autonomous Exadata VM clusters in the Oracle cloud|
36+
| list_cloud_exadata_infrastructures | List cloud Exadata infrastructure resources in a compartment|
37+
| list_cloud_vm_cluster_updates | List maintenance updates for a specific cloud VM cluster|
38+
| list_cloud_vm_clusters | List cloud VM clusters in a compartment|
39+
| list_console_connections | List console connections for a database node|
40+
| list_console_histories | List console histories for a database node|
41+
| list_container_database_patches | List patches applicable to a container database|
42+
| list_data_guard_associations | List Data Guard associations for a database|
43+
| list_database_software_images | List database software images in a compartment|
44+
| list_databases | List databases in a specified Database Home|
45+
| list_db_home_patch_history_entries | List patch history for a Database Home|
46+
| list_db_home_patches | List patches applicable to a Database Home|
47+
| list_db_homes | List Database Homes in a DB system and compartment|
48+
| list_db_nodes | List database nodes in a DB system and compartment|
49+
| list_db_servers | List Exadata DB servers for an Exadata infrastructure|
50+
| list_db_system_compute_performances | Get a list of expected compute performance for a VM DB system|
51+
| list_db_system_patches | List patches applicable to a DB system|
52+
| list_db_system_shapes | Get a list of shapes available for launching a new DB system|
53+
| list_db_system_storage_performances | Get a list of expected storage performance for a VM DB system|
54+
| list_db_systems | List DB systems in a compartment|
55+
| list_db_versions | Get a list of supported Oracle Database versions|
56+
| list_exadata_infrastructures | List Exadata Cloud@Customer infrastructure resources in a compartment|
57+
| list_exadb_vm_cluster_updates | List maintenance updates for an Exadata VM cluster on Exascale|
58+
| list_exadb_vm_clusters | List Exadata VM clusters on Exascale Infrastructure in a compartment|
59+
| list_exascale_db_storage_vaults | List Exadata Database Storage Vaults in a compartment|
60+
| list_execution_actions | List execution action resources in a compartment|
61+
| list_execution_windows | List execution window resources in a compartment|
62+
| list_external_container_databases | List external container databases in a compartment|
63+
| list_external_database_connectors | List external database connectors in a compartment|
64+
| list_external_non_container_databases | List external non-container databases in a compartment|
65+
| list_external_pluggable_databases | List external pluggable databases in a compartment|
66+
| list_flex_components | Get a list of flex components available for launching a new DB system|
67+
| list_gi_version_minor_versions | Get a list of supported Grid Infrastructure minor versions|
68+
| list_gi_versions | Get a list of supported Grid Infrastructure (GI) versions|
69+
| list_key_stores | Get a list of key stores in the specified compartment|
70+
| list_maintenance_run_history | Get a list of maintenance run histories in a compartment|
71+
| list_maintenance_runs | Get a list of maintenance runs in a compartment|
72+
| list_oneoff_patches | List one-off patches in a compartment|
73+
| list_pluggable_databases | Get a list of pluggable databases in a database or compartment|
74+
| list_scheduled_actions | List Scheduled Action resources in a compartment|
75+
| list_scheduling_plans | List Scheduling Plan resources in a compartment|
76+
| list_scheduling_policies | List Scheduling Policy resources in a compartment|
77+
| list_scheduling_windows | List Scheduling Window resources in a compartment|
78+
| list_system_versions | Get a list of supported Exadata system versions|
79+
| list_vm_cluster_networks | Get a list of VM cluster networks in a compartment|
80+
| list_vm_cluster_patches | List patches applicable to a VM cluster|
81+
| list_vm_cluster_updates | List maintenance updates for a VM cluster|
82+
| list_vm_clusters | List VM clusters in a compartment|
83+
| resource_pool_shapes | List available resource pool shapes|
84+
| create_pluggable_database | Create and start a pluggable database|
85+
| delete_pluggable_database | Delete a specific pluggable database|
86+
| get_pluggable_database | Get information about a specific pluggable database|
87+
| update_pluggable_database | Update a specific pluggable database|
88+
| get_compartment_by_name_tool | Return a compartment matching the provided name|
89+
| list_subscribed_regions_tool | Return a list of all regions the customer (tenancy) is subscribed to|
90+
91+
92+
93+
⚠️ **NOTE**: All actions are performed with the permissions of the configured OCI CLI profile. We advise least-privilege IAM setup, secure credential management, safe network practices, secure logging, and warn against exposing secrets.
94+
95+
## Third-Party APIs
96+
97+
Developers choosing to distribute a binary implementation of this project are responsible for obtaining and providing all required licenses and copyright notices for the third-party code used in order to ensure compliance with their respective open source licenses.
98+
99+
## Disclaimer
100+
101+
Users are responsible for their local environment and credential safety. Different language model selections may yield different results and performance.
102+
103+
## License
104+
105+
Copyright (c) 2025 Oracle and/or its affiliates.
106+
107+
Released under the Universal Permissive License v1.0 as shown at
108+
<https://oss.oracle.com/licenses/upl/>.
109+

‎src/database-mcp-server/oracle/__init__.py‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
"""
2+
Copyright (c) 2025, Oracle and/or its affiliates.
3+
Licensed under the Universal Permissive License v1.0 as shown at
4+
https://oss.oracle.com/licenses/upl.
5+
"""

‎src/database-mcp-server/oracle/database_mcp_server/__init__.py‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
"""
2+
Copyright (c) 2025, Oracle and/or its affiliates.
3+
Licensed under the Universal Permissive License v1.0 as shown at
4+
https://oss.oracle.com/licenses/upl.
5+
"""
6+
7+
__project__ = "oracle.database-mcp-server"
8+
__version__ = "1.0.0"

0 commit comments

Comments
 (0)