Mcp Server For Oracle Cloud Infrastructure (oci)

by jopsis

3 stars
261 downloads
Not rated
GitHub

Description

# MCP Server for Oracle Cloud Infrastructure (OCI) This project implements a Model Context Protocol (MCP) server for Oracle Cloud Infrastructure, allowing LLMs like Claude to interact directly with OCI resources. ![presentation](/images/front.jpeg) ## Features - **Dynamic…

About

# MCP Server for Oracle Cloud Infrastructure (OCI) This project implements a Model Context Protocol (MCP) server for Oracle Cloud Infrastructure, allowing LLMs like Claude to interact directly with OCI resources. ![presentation](/images/front.jpeg) ## Features - **Dynamic Profile Selection**: Switch between OCI…

Details

Author
jopsis
GitHub stars
3
Downloads
261
Categories
Cloud Service, Infrastructure, Database

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Server For Oracle Cloud Infrastructure (oci)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via pip from the repository, then start the server with python -m mcp_server_oci.mcp_server. Optionally specify a default profile with --profile <name>. Configure Claude Desktop by adding a JSON entry to claude_desktop_config.json.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp server for oracle cloud infrastructure (oci)": {
            "mcp-server-oci": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_oci.mcp_server",
                    "--profile",
                    "DEFAULT"
                ],
                "env": {
                    "PYTHONPATH": "/<PATH_TO_MCP>/mcp-server-oci",
                    "FASTMCP_LOG_LEVEL": "INFO"
                }
            }
        }
    }
}

McpServers

{
    "mcp-server-oci": {
        "command": "python",
        "args": [
            "-m",
            "mcp_server_oci.mcp_server",
            "--profile",
            "DEFAULT"
        ],
        "env": {
            "PYTHONPATH": "/<PATH_TO_MCP>/mcp-server-oci",
            "FASTMCP_LOG_LEVEL": "INFO"
        }
    }
}

MCP Server for Oracle Cloud Infrastructure (OCI)

This project implements a Model Context Protocol (MCP) server for Oracle Cloud Infrastructure, allowing LLMs like Claude to interact directly with OCI resources.

presentation

Features

- Dynamic Profile Selection: Switch between OCI profiles/tenancies without restarting the server
- Connection to Oracle Cloud using standard OCI CLI configuration
- 85 comprehensive tools to list and manage OCI resources across 11+ service categories
- Instance lifecycle management (start, stop)
- Database Systems and DB Nodes management
- Container Engine for Kubernetes (OKE) cluster and node pool management
- Integration with the MCP protocol to facilitate access from Claude Desktop

Prerequisites

- Python 3.10 or higher
- OCI CLI configured (oci setup config)
- Appropriate permissions in Oracle Cloud

Installation

Clone this repo

pip install git+https://github.com/modelcontextprotocol/python-sdk.git
pip install oci fastapi uvicorn click pydantic loguru
pip install -e .

Usage

Starting the Server

Option 1: Dynamic Profile Selection (Recommended)

Start without a profile and select it at runtime:

python -m mcp_server_oci.mcp_server

Then use the MCP tools to manage profiles:
- list_oci_profiles - See available profiles from ~/.oci/config
- set_oci_profile - Activate a specific profile
- get_current_oci_profile - Check which profile is active

Option 2: With Default Profile

Start with a specific profile pre-loaded:

python -m mcp_server_oci.mcp_server --profile DEFAULT

With uv:

uv --directory /path/to/mcp-server-oci run python -m mcp_server_oci.mcp_server --profile DEFAULT

Switching Between Tenancies

You can switch between different OCI tenancies without restarting:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.