oracle/mcp

Repository containing reference implementations of MCP (Model Context Protocol) servers for managing and interacting with Oracle products. Each MCP server under src/ may be written in a different programming language, demonstrating MCP’s language-agnostic approach.
## What is MCP?
The Model Context Protocol (MCP) enables standardized, language-agnostic machine-to-machine workflows across data, models, and cloud resources. MCP servers implement specific tool suites, exposing them to MCP-compatible clients.
## Project Scope
Proof-of-concept/Reference implementations:
This repository is not intended for production use; servers are provided as reference and for exploration, prototyping, and learning.
Polyglot architecture:
Each src/ / directory represents a distinct MCP server, and these may use Python, Node.js, Java, or other languages.
## Prerequisites
Supported OS: Linux, macOS, or Windows (varies by server; check server README)
Git (for cloning this repository)
Internet access (for downloading dependencies)
Cloud access: Some servers require Oracle Cloud Infrastructure (OCI) credentials and configuration (OCI docs)
Note:
Each MCP server has its own specific requirements (e.g., language runtime version, libraries).
Always see the respective src/ /README.md for detailed setup instructions.
## Quick Start
Follow these instructions to get started as quickly as possible. Once finished, look here to set up your local development environment if you wish to contribute changes.
1. Install uv from here
2. Install python with uv python install 3.13
3. If you are using OCI servers, configure your OCI authentication
4. Choose a server below and add it to your MCP client configuration
### Choose an OCI server
For most OCI users, start with oci-cloud-mcp-server. It uses the official OCI Python SDK directly, without OCI CLI subprocess calls, and is the recommended general-purpose entry point for OCI workflows.
Use oci-api-mcp-server instead when you specifically want an MCP server backed by the OCI CLI. It exposes tools for discovering and running OCI CLI commands.
Choose one of the other purpose-built servers when you already know the Oracle product or OCI domain you want to work with. These servers target specific service and product workflows rather than providing a general OCI entry point. Browse the src/ directories and read the relevant src/ /README.md before configuring one.
### Recommended: OCI Cloud MCP Server
Run the server over stdio:
sh
uvx oracle.oci-cloud-mcp-server@latest
Then add this minimal configuration to your MCP client. Replace with the OCI CLI profile configured during authentication.
For macOS/Linux:
json
"mcpServers": {
"oracle-oci-cloud-mcp-server": {
"command": "uvx",
"args": [
"oracle.oci-cloud-mcp-server@latest"
],
"env": {
"OCICONFIGPROFILE": " ",
"FASTMCPLOGLEVEL": "ERROR"
### Alternative: OCI API MCP Server
Use this CLI-backed option when you specifically need OCI CLI commands:
sh
uvx oracle.oci-api-mcp-server@latest
json
"mcpServers": {
"oracle-oci-api-mcp-server": {
"command": "uvx",
"args": [
"oracle.oci-api-mcp-server@latest"
],
"env": {
"OCICONFIGPROFILE": " ",
"FASTMCPLOGLEVEL": "ERROR"
To connect to an OCI MCP server running in HTTP streaming mode: