mcp-server-oci
Provides tools for managing Oracle Kubernetes Engine (OKE) clusters, node pools, and obtaining kubeconfig for kubectl.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-ocilist all compute instances in my compartment"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Skill MCP permettant aux LLM comme Claude d'interagir directement avec Oracle Cloud Infrastructure via le Model Context Protocol.
✨ Caractéristiques
Sélection dynamique de profils : basculez entre les profils/locations OCI sans redémarrer le serveur
Connexion OCI standard : utilise la configuration standard de l'interface CLI OCI
85 outils complets couvrant plus de 11 catégories de services OCI
Gestion du cycle de vie des instances (démarrage, arrêt)
Gestion des systèmes de bases de données et des nœuds de bases de données
Gestion des clusters OKE et des pools de nœuds Kubernetes
Intégration native Claude Desktop via le protocole MCP
Related MCP server: OCI MCP Server
📜 Licence
Ce projet est distribué sous une licence personnelle non commerciale.
✅ Usage personnel gratuit — Pour tout développeur individuel à des fins non commerciales. ❌ Usage commercial interdit — Toute utilisation commerciale nécessite une licence commerciale.
Zehair Louzza détient l'intégralité des droits sur ce logiciel (droits intellectuels, commerciaux et moraux).
👉 Voir LICENSE pour les termes complets. 👉 Pour un usage commercial : COMMERCIAL_LICENSE.md ou 📧 contact@journeyinto-ai.com
🚀 Pro Services & MVPs
Des services professionnels et des licences commerciales sont disponibles directement auprès de l'auteur.
Offre | Cible | Détails |
Licence Individuelle Pro | Freelances, consultants solo | Droits commerciaux pour usage individuel |
Licence Team / Startup | Équipes ≤ 10 ingénieurs | Support prioritaire + outils personnalisés |
Licence Enterprise | Entreprises, MSP, intégrateurs cloud | Droits illimités, white-label, NDA |
MVPs disponibles
OCI Infrastructure Monitor — Dashboard SaaS temps réel (FastAPI + React + OCI MCP)
AI-Powered OCI Ops Assistant — Assistant conversationnel LLM pour gérer OCI en langage naturel
Multi-Cloud Data Pipeline — Pipeline OCI → Snowflake/Supabase avec dbt et monitoring
Custom MCP Tool Development — Développement d'outils OCI sur mesure
👉 Voir COMMERCIAL_LICENSE.md pour les détails complets. 📧 Contact : contact@journeyinto-ai.com
📦 Prérequis
Python 3.10 ou version ultérieure
CLI OCI configurée (
oci setup config)Autorisations appropriées dans Oracle Cloud
🚀 Installation
# 1. Clonez ce dépôt
git clone https://github.com/zehair-louzza/mcp-server-oci.git
cd mcp-server-oci
# 2. Installez le SDK MCP
pip install git+https://github.com/modelcontextprotocol/python-sdk.git
# 3. Installez les dépendances
pip install oci fastapi uvicorn click pydantic loguru
# 4. Installez le package en mode éditable
pip install -e .▶️ Usage
Option 1 : Sélection dynamique du profil (recommandée)
python -m mcp_server_oci.mcp_serverPuis utilisez les outils MCP pour gérer les profils :
Outil | Description |
| Consulter les profils dans |
| Activer un profil spécifique |
| Vérifier quel profil est actif |
Option 2 : Avec profil par défaut
python -m mcp_server_oci.mcp_server --profile DEFAULTAvec uv
uv --directory /path/to/mcp-server-oci run python -m mcp_server_oci.mcp_server --profile DEFAULT🖥️ Configuration Claude Desktop (macOS)
Ajoutez cette configuration dans :
/Users/<username>/Library/Application Support/Claude/claude_desktop_config.json
Profil dynamique (recommandé)
{
"mcpServers": {
"mcp-server-oci": {
"command": "python",
"args": ["-m", "mcp_server_oci.mcp_server"],
"env": {
"PYTHONPATH": "/<PATH_TO_MCP>/mcp-server-oci",
"FASTMCP_LOG_LEVEL": "INFO"
}
}
}
}Profil fixe
{
"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"
}
}
}
}Avec uv et profils dynamiques
{
"mcpServers": {
"mcp-server-oci": {
"command": "uv",
"args": ["--directory", "/<PATH_TO_MCP>/mcp-server-oci", "run", "python", "-m", "mcp_server_oci.mcp_server"],
"env": {
"FASTMCP_LOG_LEVEL": "INFO"
}
}
}
}📋 85 Outils MCP disponibles
🔑 Gestion des profils
Outil | Description |
| Lister tous les profils OCI dans |
| Activer un profil spécifique |
| Afficher le profil actif |
👤 Identités et Accès (IAM)
Outil | Description |
| Lister tous les compartiments accessibles |
| Lister les utilisateurs IAM avec statut MFA |
| Détails utilisateur + appartenances aux groupes |
| Lister les groupes IAM avec nombre de membres |
| Détails groupe avec liste des membres |
| Lister les politiques IAM avec déclarations |
| Détails d'une politique avec toutes les règles |
| Lister les groupes dynamiques avec règles |
| Détails groupe dynamique + règles principales |
🖥️ Instances de calcul
Outil | Description |
| Lister les VM dans un compartiment |
| Détails d'une instance |
| Démarrer une instance arrêtée |
| Arrêter une instance (progressif/forcé) |
🗄️ Bases de données
Outil | Description |
| Lister les systèmes de bases de données |
| Détails d'un système de BDD |
| Lister les nœuds de BDD |
| Détails d'un nœud de BDD |
| Démarrer un nœud arrêté |
| Arrêter un nœud (progressif/forcé) |
| Redémarrer un nœud |
| Forcer le redémarrage d'un nœud |
| Redémarrage logiciel d'un nœud |
| Démarrer tous les nœuds d'un système |
| Arrêter tous les nœuds d'un système |
| Lister les bases de données d'un compartiment |
| Détails BDD + chaînes de connexion + PDB |
| Lister les ADB avec type de charge de travail |
| Détails ADB + portefeuille + auto-scaling |
🌐 Réseau
Outil | Description |
| Lister les VCN avec blocs CIDR |
| Détails VCN incluant IPv6 |
| Lister les sous-réseaux |
| Détails sous-réseau + sécurité + routage |
| Lister les VNIC d'un compartiment/instance |
| Détails VNIC + IPs + NSG |
| Lister les listes de sécurité avec règles |
| Détails liste de sécurité |
| Lister les NSG |
| Détails NSG avec toutes les règles |
💾 Stockage
Outil | Description |
| Espace de noms Object Storage |
| Lister les buckets Object Storage |
| Détails bucket + accès public + versionnage |
| Lister les volumes Block Storage |
| Détails volume + performance + sauvegarde |
| Lister les volumes de démarrage |
| Détails volume boot + image source |
| Lister les systèmes de fichiers |
| Détails + octets mesurés + instantanés |
⚖️ Équilibreurs de charge
Outil | Description |
| Lister les load balancers classiques |
| Détails + backends + écouteurs + certificats |
| Lister les NLB |
| Détails NLB + config backend |
🏗️ Infrastructure & Services publics
Outil | Description |
| Lister les domaines de disponibilité |
| Lister les domaines de panne |
| Lister les images de calcul (OS, version, taille) |
| Détails image + options de lancement |
| Lister les shapes (CPU, RAM, GPU, réseau) |
| Lister toutes les régions OCI |
| Infos de la location + région d'origine |
🔐 Sécurité & Chiffrement (KMS)
Outil | Description |
| Lister les coffres KMS |
| Détails coffre + points de terminaison |
| Lister les clés de chiffrement dans un coffre |
| Détails clé + algorithme + structure + versions |
💰 Gestion des coûts
Outil | Description |
| Récapitulatif coûts/utilisation (quotidien/mensuel) |
| Ventilation des coûts par service |
| Ventilation des coûts par compartiment |
| Lister les budgets avec dépenses réelles/prévues |
| Détails budget + objectifs + règles d'alerte |
📊 Surveillance & Observabilité
Outil | Description |
| Lister les alarmes avec sévérité et destinations |
| Détails alarme + seuils + notifications |
| Historique des états avec horodatage |
| Lister les métriques disponibles + espaces de noms |
| Interroger les données métriques avec MQL |
| Rechercher des journaux (Log Search API) |
| Lister les groupes de journaux |
| Lister les journaux d'un groupe |
☸️ Container Engine for Kubernetes (OKE)
Outil | Description |
| Lister les clusters OKE avec version K8s |
| Détails cluster + réseau + addons + upgrades |
| Obtenir le kubeconfig pour kubectl |
| Lister les pools de nœuds |
| Détails pool + nœuds + éviction + cycling |
| Lister les opérations asynchrones OKE |
| État et avancement d'une work request |
💡 Exemples d'utilisation
Gestion des profils
# Depuis Claude ou tout client MCP :
"Show me all available OCI profiles"
"Set the OCI profile to 'production'"
"What OCI profile am I currently using?"
"Switch to the DEFAULT profile"IAM & Sécurité
"List all IAM users in my tenancy"
"Does this user have MFA enabled?"
"List all IAM groups in compartment X"
"List all IAM policies in the root compartment"
"What permissions does this policy grant?"
"Which users have admin access?"
"What dynamic groups allow instance principals?"Instances de calcul
"Show me all compute instances in compartment ocid1.compartment.oc1..."
"Get details for instance ocid1.instance.oc1..."
"Start the instance ocid1.instance.oc1..."
"Stop the instance ocid1.instance.oc1... with force stop"Bases de données
"Show me all DB Systems in compartment ocid1.compartment.oc1..."
"List all databases in compartment X"
"Get connection strings for database ocid1.database.oc1..."
"List all Autonomous Databases in compartment Z"
"Is auto-scaling enabled on this Autonomous Database?"Réseau
"List all VCNs in compartment ocid1.compartment.oc1..."
"List all subnets in VCN ocid1.vcn.oc1..."
"Show me all security lists in compartment X"
"List all network security groups in VCN Y"
"List all VNICs for instance ocid1.instance.oc1..."Stockage
"What is my Object Storage namespace?"
"List all buckets in compartment X"
"Is bucket 'public-bucket' publicly accessible?"
"List all volumes in compartment Y"
"List all file systems in compartment W and AD-1"Équilibreurs de charge
"List all load balancers in compartment X"
"What backend sets and listeners does this load balancer have?"
"List all network load balancers in compartment Y"
"Which load balancers are private vs public?"Infrastructure
"List all availability domains in my tenancy"
"List all compute shapes available in compartment Y"
"What shapes support GPU?"
"List all available OCI regions"
"What is my tenancy name and home region?"KMS & Sécurité
"List all vaults in compartment X"
"List all encryption keys in vault Y"
"What algorithm and protection mode does this key use?"Gestion des coûts
"Show me cost and usage summary for the last 30 days"
"Get cost breakdown by service from 2024-01-01 to 2024-01-31"
"Which services are costing the most?"
"List all budgets in compartment X"
"What is my actual spend vs budget?"Surveillance
"List all alarms in compartment X"
"What alarms are currently firing?"
"Show me alarm history for the last 24 hours"
"Query CpuUtilization for the last hour"
"Search logs for errors in the last hour"
"Search for 'ERROR' in application logs"OKE (Kubernetes)
"List all OKE clusters in compartment X"
"What Kubernetes version is this cluster running?"
"Get the kubeconfig for cluster ocid1.cluster.oc1..."
"List all node pools in compartment Y"
"Show me all work requests that failed"
"Which node pools are running outdated Kubernetes versions?"🚀 Historique des versions
Version | Catégorie | Nouveautés | Nbre d'outils |
v1.15 | OKE ☸️ | 7 outils : clusters, node pools, work requests | 85 |
v1.14 | Surveillance 🔍 | 8 outils : alarmes, métriques, journaux | 78 |
v1.13 | Coûts 💰 | 5 outils : analyse coûts, budgets | 70 |
v1.12 | Sécurité/KMS 🔐 | 4 outils : coffres-forts, clés | 65 |
v1.11 | Infrastructure 🏗️ | 7 outils : AD, FD, images, shapes, régions | 61 |
v1.10 | Load Balancers ⚖️ | 4 outils : LB classique et réseau | 54 |
v1.9 | IAM 🔐 | 8 outils : users, groupes, policies, dyn. groups | 50 |
v1.8 | BDD 🗄️ | 4 outils : BDD classiques et autonomes | 42 |
v1.7 | Stockage 💾 | 9 outils : object, block, file storage | 38 |
v1.6 | Réseau 🌐 | 10 outils : VCN, subnets, VNIC, NSG | 29 |
v1.5 | Profils 🔥 | Sélection dynamique multi-locataires | 19 |
v1.0 | Base | Compute + DB Nodes | — |
📚 Documentation
🤝 Contribuer
Les contributions sont les bienvenues pour un usage non commercial ! Le code source suit les patterns suivants :
Gestion hybride des erreurs : lever une exception pour les erreurs techniques, retourner un dictionnaire pour les états métier
Opérations asynchrones : pas d'appels bloquants (
time.sleep())Configuration centralisée : constantes dans
config.pyPrincipe DRY : décorateurs pour les patterns communs (
mcp_tool_wrapper)
⚠️ Toute contribution reste soumise aux termes de la licence. En contribuant, vous acceptez que vos modifications soient intégrées sous la même licence et que les droits restent la propriété exclusive de Zehair Louzza.
📝 Licence & Contact
Ce projet est sous licence personnelle non commerciale. Zehair Louzza détient l'intégralité des droits sur ce logiciel.
© 2026 Zehair Louzza. All rights reserved.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zehair-louzza/OracleMind'
If you have feedback or need assistance with the MCP directory API, please join our Discord server