OCI Database Observability MCP Server
This package provides one MCP server for OCI Operations Insights (OPSI),
Database Management (DBM), and OCI Monitoring observability workflows. It
exposes catalog discovery and invocation tools. Use oci-identity-mcp-server
for compartment discovery and pass the resulting OCID to this server.
Running
STDIO
uvx oracle.oci-db-observability-mcp-server
Use a named OCI CLI profile when required:
OCI_CONFIG_PROFILE=<profile_name> uvx oracle.oci-db-observability-mcp-server
Discovery workflow
- For a compartment-scoped operation, use
oci-identity-mcp-serverto list compartments or resolve a compartment name. Use the returned compartment OCID ascompartment_id; do not invent an OCID. - Call
list_dbo_skillswhen the relevant capability is not already known. - Call
list_dbo_toolsfor selected skills when the required operation is not already known. - Call
describe_dbo_toolwhen the selected tool's schema is unavailable, outdated, or uncertain. Previously retrieved applicable results may be reused. - Call
invoke_dbo_toolwith arguments matching the known schema.
The complete skill and tool catalogs are packaged as JSON under
oracle/oci_db_observability_mcp_server/metadata. Skills organize
read-only workflows such as inventory, diagnostics, performance, and fleet
analysis. Their concise descriptions are MCP discovery metadata, not MCP
resources; the detailed OEM.ai skill files are not packaged or required at
runtime. The tool catalog contains OPSI, DBM, and OCI Monitoring operations;
it does not expose the individual operations as MCP tools.
OCI Monitoring metric and alarm workflow
The database-and-infra-observability-metric-catalog skill provides three
local catalog tools (search, get, and list), one live metric reader, and three
read-only alarm tools. First identify a metric using the local catalog, then
read a specific metric with its exact namespace/name, explicit RFC 3339 time
window, allowed dimensions, aggregation, interval, and resolution. The metric
reader turns that request into MQL and makes one
MonitoringClient.summarize_metrics_data call. Alarm definition and state
tools each make one respective OCI Monitoring SDK call. No tool changes OCI
resources.
Pagination
Paginated operations accept an optional page argument. Responses contain the
page data and a nextPage token when more results are available:
{
"data": [],
"nextPage": "<token>"
}
Pass the returned nextPage value as page in the next invocation. Stop when
nextPage is null.
Development
Run the unified server tests with:
make test project=oci-db-observability-mcp-server
Run repository lint with:
make lint
Third-Party APIs
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.
License
Copyright (c) 2026 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0.
1 maintainer
Metadata
1 maintainer
Release files for oracle.oci-db-observability-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| oracle_oci_db_observability_mcp_server-0.1.0.tar.gz | 75.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| oracle_oci_db_observability_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 147.2 kB
Release files / oracle_oci_db_observability_mcp_server-0.1.0.tar.gz
| Download URL | oracle_oci_db_observability_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 75.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
11073e3d3cf5c37c060372ab592fdfdc19585501f53e5ee0a90b704fa90d9ba0
|
|
BLAKE2b-256 checksum How to use checksums |
dce7b58c155e9abe1984c54045fa59817b1ac6c42b785c0f758260478c57ed04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Oracle Linux Server","version":"9.8","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / oracle_oci_db_observability_mcp_server-0.1.0-py3-none-any.whl
| Download URL | oracle_oci_db_observability_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 71.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eba8d7aaf8fc3c112e87652ca676d5f9e9a2ca6174b8ae43e2aa9ed152ee2620
|
|
BLAKE2b-256 checksum How to use checksums |
813180b5900752a9a20bacaeece79a18e699c4895f6173a71856ca9f9ff1f4c2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Oracle Linux Server","version":"9.8","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for oracle.oci-db-observability-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
