Labsco
jopsis logo

MCP Server for Oracle Cloud Infrastructure (OCI)

★ 3

from jopsis

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

🔥🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#database#devops#git#weather#finance#security#monitoring

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

📋 Available MCP Tools

Profile Management 🆕

  • list_oci_profiles - List all available OCI profiles from ~/.oci/config
  • set_oci_profile - Activate a specific profile for API calls
  • get_current_oci_profile - Show currently active profile

Identity & Access Management 🆕

Compartments

  • list_compartments - List all compartments accessible to you

Users

  • list_users - List all IAM users in a compartment with capabilities and MFA status
  • get_user - Get detailed user information including group memberships

Groups

  • list_groups - List all IAM groups in a compartment with member count
  • get_group - Get detailed group information including members

Policies

  • list_policies - List all IAM policies in a compartment with statements
  • get_policy - Get detailed policy information with all policy statements

Dynamic Groups

  • list_dynamic_groups - List all dynamic groups with matching rules
  • get_dynamic_group - Get detailed dynamic group info with instance principal rules

Compute Resources

  • list_instances - List virtual machine instances in a compartment
  • get_instance - Get detailed information about a specific instance
  • start_instance - Start a stopped instance
  • stop_instance - Stop a running instance (supports soft/force stop)

Databases 🔥

DB Systems

  • list_db_systems - List DB Systems in a compartment
  • get_db_system - Get detailed DB System information
  • list_db_nodes - List DB Nodes in a compartment (optionally filtered by DB System)
  • get_db_node - Get detailed DB Node information
  • start_db_node - Start a stopped DB Node
  • stop_db_node - Stop a running DB Node (soft or hard stop)
  • reboot_db_node - Reboot a DB Node
  • reset_db_node - Reset (force reboot) a DB Node
  • softreset_db_node - Soft reset (graceful reboot) a DB Node
  • start_db_system - Start all nodes of a DB System
  • stop_db_system - Stop all nodes of a DB System

Regular Databases 🆕

  • list_databases - List databases in a compartment (optionally filtered by DB System)
  • get_database - Get detailed database information including connection strings and PDB name

Autonomous Databases 🆕

  • list_autonomous_databases - List Autonomous Databases with workload type and connection info
  • get_autonomous_database - Get detailed ADB info including wallet info and auto-scaling settings

Networking

Virtual Cloud Networks (VCNs)

  • list_vcns - List all VCNs in a compartment with CIDR blocks and DNS info
  • get_vcn - Get detailed VCN information including IPv6 CIDR blocks

Subnets

  • list_subnets - List all subnets in a compartment (optionally filtered by VCN)
  • get_subnet - Get detailed subnet information with security lists and routing

Virtual Network Interface Cards (VNICs)

  • list_vnics - List all VNICs in a compartment (optionally filtered by instance)
  • get_vnic - Get detailed VNIC information including IP addresses and NSG associations

Security

  • list_security_lists - List security lists with ingress/egress rules (optionally filtered by VCN)
  • get_security_list - Get detailed security list with all rules
  • list_network_security_groups - List Network Security Groups (NSGs) in a compartment
  • get_network_security_group - Get detailed NSG information with all security rules

Storage 🆕

Object Storage

  • get_namespace - Get the Object Storage namespace for the tenancy
  • list_buckets - List all Object Storage buckets in a compartment
  • get_bucket - Get detailed bucket information including public access settings and versioning

Block Storage

  • list_volumes - List all Block Storage volumes in a compartment
  • get_volume - Get detailed volume information including size, performance tier, and backup policy
  • list_boot_volumes - List all boot volumes in a compartment (optionally filtered by AD)
  • get_boot_volume - Get detailed boot volume information including source image

File Storage

  • list_file_systems - List all File Storage file systems in a compartment and AD
  • get_file_system - Get detailed file system information including metered bytes and snapshots

Load Balancers 🆕

Classic Load Balancers

  • list_load_balancers - List all classic load balancers in a compartment
  • get_load_balancer - Get detailed load balancer information including backend sets, listeners, and certificates

Network Load Balancers

  • list_network_load_balancers - List all network load balancers in a compartment
  • get_network_load_balancer - Get detailed network load balancer information including backend sets and listeners

Infrastructure Utilities 🆕

Availability and Fault Domains

  • list_availability_domains - List all availability domains in a compartment
  • list_fault_domains - List all fault domains in an availability domain

Compute Images

  • list_images - List all compute images with OS, version, and size
  • get_image - Get detailed image information including launch options

Compute Shapes

  • list_shapes - List all compute shapes with CPU, memory, network, and GPU specs

Regions and Tenancy

  • list_regions - List all available OCI regions
  • get_tenancy_info - Get tenancy details including name and home region

Security & Encryption 🆕

KMS Vaults

  • list_vaults - List all KMS vaults in a compartment
  • get_vault - Get detailed vault information including crypto and management endpoints

Encryption Keys

  • list_keys - List all encryption keys in a vault's compartment
  • get_key - Get detailed key information including algorithm, shape, and versions

Cost Management 🆕

Usage and Cost Analysis

  • get_cost_usage_summary - Get cost and usage summary for a tenancy with daily or monthly granularity
  • get_cost_by_service - Get cost breakdown by service for a specified time period
  • get_cost_by_compartment - Get cost breakdown by compartment for a specified time period

Budgets

  • list_budgets - List all budgets with amount, actual spend, and forecasted spend
  • get_budget - Get detailed budget information including targets and alert rules

Monitoring & Observability 🆕

Alarms

  • list_alarms - List all alarms with query, severity, and destinations
  • get_alarm - Get detailed alarm information including thresholds and notification settings
  • get_alarm_history - Get alarm state history with timestamps and state transitions

Metrics

  • list_metrics - List available metrics with namespaces and dimensions
  • query_metric_data - Query metric data for a time range using MQL

Logs

  • search_logs - Search logs using the Logging Search API
  • list_log_groups - List all log groups in a compartment
  • list_logs - List all logs in a log group with types and retention

Container Engine for Kubernetes (OKE) 🆕

Clusters

  • list_oke_clusters - List all OKE clusters with Kubernetes version and endpoints
  • get_oke_cluster - Get detailed cluster info including network config, add-ons, and available upgrades
  • get_oke_cluster_kubeconfig - Get kubeconfig file content for kubectl access

Node Pools

  • list_oke_node_pools - List node pools with shape, image, and placement configuration
  • get_oke_node_pool - Get detailed node pool info including individual nodes, eviction settings, and cycling details

Work Requests

  • list_oke_work_requests - List async operations (create, update, delete) for OKE resources
  • get_oke_work_request - Get detailed work request status and progress

🚀 Recent Improvements

v1.15 - Container Engine for Kubernetes (OKE) Tools (Latest) ☸️

  • 7 new OKE tools: Clusters, Node Pools, and Work Requests
  • Clusters: List/get clusters with Kubernetes version, endpoints, network config, and available upgrades
  • Kubeconfig: Get kubeconfig file content for kubectl access to clusters
  • Node Pools: List/get node pools with detailed node information, placement config, and eviction settings
  • Work Requests: Track async operations (create, update, delete) for OKE resources
  • Essential for managing Kubernetes infrastructure on OCI
  • Total MCP tools increased from 78 to 85
  • Added comprehensive OKE usage examples in README

v1.14 - Monitoring & Observability Tools 🔍

  • 8 new monitoring tools: Alarms, Metrics, and Logs
  • Alarms: List/get alarms with severity, query history, and state transitions
  • Metrics: List metrics, query time-series data with MQL for performance analysis
  • Logs: Search logs, list log groups and logs for troubleshooting
  • Essential for real-time monitoring, troubleshooting, and incident response
  • Total MCP tools increased from 70 to 78
  • Added comprehensive monitoring & observability usage examples in README

v1.13 - Cost Management Tools 💰

  • 5 new cost management tools: Usage/Cost Analysis and Budgets
  • Usage Analysis: Get cost summaries with daily/monthly granularity
  • Cost Breakdown: Analyze costs by service or compartment for any time period
  • Budget Management: List/get budgets with actual spend, forecasted spend, and alert rules
  • Essential for cost optimization, budget tracking, and financial governance
  • Total MCP tools increased from 65 to 70
  • Added comprehensive cost management usage examples in README

v1.12 - Security & Encryption Tools 🔐

  • 4 new security tools: KMS Vaults and Encryption Keys
  • KMS Vaults: List/get vaults with crypto and management endpoints
  • Encryption Keys: List/get keys with algorithm, protection mode, and key shape
  • Complete KMS coverage: Vault management and key discovery
  • Dynamic KMS Management client creation using vault endpoints
  • Total MCP tools increased from 61 to 65
  • Added comprehensive security & encryption usage examples in README

v1.11 - Infrastructure Utilities 🏗️

  • 7 new infrastructure tools: Availability Domains, Fault Domains, Images, Shapes, Regions, and Tenancy
  • Availability/Fault Domains: List ADs and FDs for high availability planning
  • Compute Images: List/get images with OS versions and launch options
  • Compute Shapes: List shapes with CPU, memory, network, and GPU specifications
  • Regions & Tenancy: List all regions and get tenancy information
  • Essential for resource planning, capacity management, and infrastructure discovery
  • Total MCP tools increased from 54 to 61
  • Added comprehensive infrastructure utilities usage examples in README

v1.10 - Load Balancer Tools ⚖️

  • 4 new load balancer tools: Classic Load Balancers and Network Load Balancers
  • Classic Load Balancers: List/get LBs with backend sets, listeners, and certificates
  • Network Load Balancers: List/get NLBs with backend configuration and IP preservation
  • Complete load balancing coverage: Layer 7 (classic) and Layer 4 (network) load balancers
  • Total MCP tools increased from 50 to 54
  • Added comprehensive load balancer usage examples in README

v1.9 - Identity & Access Management Tools 🔐

  • 8 new IAM tools: Users, Groups, Policies, Dynamic Groups
  • Security auditing: Review user capabilities, MFA status, and group memberships
  • Policy management: List and inspect all IAM policy statements
  • Dynamic groups: View instance principal matching rules
  • Essential for compliance, security audits, and access troubleshooting
  • Total MCP tools increased from 42 to 50
  • Added comprehensive IAM usage examples in README

v1.8 - Database Tools 🗄️

  • 4 new database tools: Regular Databases and Autonomous Databases
  • Regular Databases: List/get databases with connection strings and PDB names
  • Autonomous Databases: List/get ADB with workload type, wallet info, and auto-scaling
  • Complete database ecosystem coverage: DB Systems, DB Nodes, Databases, and ADB
  • Total MCP tools increased from 38 to 42
  • Added comprehensive database usage examples in README

v1.7 - Storage Tools 💾

  • 9 new storage tools: Object Storage, Block Storage, File Storage
  • Object Storage: Get namespace, list/get buckets with public access info
  • Block Storage: List/get volumes and boot volumes with performance tiers
  • File Storage: List/get file systems with metered bytes
  • Total MCP tools increased from 29 to 38
  • Added comprehensive storage usage examples in README

v1.6 - Comprehensive Networking Tools 🌐

  • 10 new networking tools: VCNs, Subnets, VNICs, Security Lists, NSGs
  • Network topology discovery: Complete visibility of network infrastructure
  • Security auditing: Review security rules and network access controls
  • Connectivity troubleshooting: VNIC and routing information
  • Total MCP tools increased from 19 to 29
  • Added comprehensive networking usage examples in README

v1.5 - Dynamic Profile Selection 🔥

  • Multi-tenancy support: Switch between OCI profiles without restarting
  • New MCP tools: list_oci_profiles, set_oci_profile, get_current_oci_profile
  • Profile requirement validation in all OCI tools
  • Optional --profile argument (lazy initialization)
  • Complete documentation in DYNAMIC_PROFILE_SELECTION.md
  • Updated README with accurate tool listing

v1.4 - Centralized Configuration

  • Created centralized config.py with all configuration constants
  • Eliminated magic numbers throughout the codebase
  • Improved maintainability and discoverability of configuration values

v1.3 - Async Operations

  • Removed all blocking time.sleep() calls
  • Made all operations truly asynchronous
  • Improved server responsiveness

v1.2 - Standardized Error Handling

  • Implemented Hybrid Error Handling Pattern
  • Technical errors → raise exceptions
  • Business states → return success dictionaries
  • Comprehensive documentation in ERROR_HANDLING_PATTERN.md

v1.1 - DRY Principle

  • Created mcp_tool_wrapper decorator
  • Eliminated ~150 lines of repetitive code
  • Consistent error handling and logging across all tools

v1.0 - Code Cleanup

  • Removed unused/obsolete files
  • Cleaned up commented code
  • Established clean baseline

📚 Documentation

🤝 Contributing

Contributions are welcome! The codebase follows these patterns:

  • Hybrid error handling (raise for technical errors, return dict for business states)
  • Async operations (no blocking calls)
  • Centralized configuration (constants in config.py)
  • DRY principle (use decorators for common patterns)

📝 License

[Add your license here]