MCP Server Oci

🚀 Oracle Cloud Infrastructure (OCI) 用 MCP サーバー

このプロジェクトは、Oracle Cloud Infrastructure 用の Model Context Protocol (MCP) サーバーを実装しています。これにより、Claude などの大規模言語モデル (LLM) が OCI リソースと直接やり取りすることが可能になります。

✨ 主な機能

• 動的プロファイル選択：サーバーを再起動することなく、OCI のプロファイルやテナンシーを切り替えることができます。
• 標準の OCI CLI 構成を使用して Oracle Cloud に接続します。
• OCI リソースを一覧表示し管理するための包括的なツールが用意されています。
• インスタンスのライフサイクル管理（起動、停止）が可能です。
• データベースシステムと DB ノードの管理ができます。
• MCP プロトコルと統合されており、Claude Desktop からのアクセスを容易にします。

📋 前提条件

• Python 3.10 以上
• OCI CLI が構成されていること (oci setup config)
• Oracle Cloud で適切な権限を持っていること

📦 インストール

このリポジトリをクローンします。

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

💻 使用例

サーバーの起動

オプション 1: 動的プロファイル選択（推奨） プロファイルを指定せずに起動し、実行時に選択します。

python -m mcp_server_oci.mcp_server

その後、MCP ツールを使用してプロファイルを管理します。

• list_oci_profiles - ~/.oci/config から利用可能なプロファイルを表示します。
• set_oci_profile - 特定のプロファイルをアクティブにします。
• get_current_oci_profile - 現在アクティブなプロファイルを確認します。

オプション 2: デフォルトプロファイルを使用 特定のプロファイルを事前に読み込んで起動します。

python -m mcp_server_oci.mcp_server --profile DEFAULT

uv を使用する場合:

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

テナンシーの切り替え

サーバーを再起動することなく、異なる OCI テナンシーを切り替えることができます。

# MCP クライアント（例: Claude）で実行します。
# 1. 利用可能なプロファイルを表示
"Show me available OCI profiles"

# 2. 別のテナンシーに切り替える
"Switch to the 'production' OCI profile"

# 3. 現在のプロファイルを確認
"What OCI profile am I using?"

MacOS の Claude Desktop 用の設定

以下の設定をファイルに追加します。 /Users/<usuario>/Library/Application Support/Claude/claude_desktop_config.json

動的プロファイル選択（推奨）

"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"
    }
  }
}

固定プロファイルを使用

"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"
    }
  }
}

uv と動的プロファイルを使用

"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"
    }
  }
}

📋 利用可能な MCP ツール

プロファイル管理 🆕

• list_oci_profiles - ~/.oci/config から利用可能なすべての OCI プロファイルを表示します。
• set_oci_profile - API 呼び出しに使用する特定のプロファイルをアクティブにします。
• get_current_oci_profile - 現在アクティブなプロファイルを表示します。

アイデンティティとアクセス管理

• list_compartments - あなたがアクセスできるすべてのコンパートメントを表示します。

コンピュートリソース

• list_instances - コンパートメント内の仮想マシンインスタンスを表示します。
• get_instance - 特定のインスタンスの詳細情報を取得します。
• start_instance - 停止しているインスタンスを起動します。
• stop_instance - 実行中のインスタンスを停止します（ソフト停止または強制停止が可能）。

データベースシステム 🔥

• list_db_systems - コンパートメント内の DB システムを表示します。
• get_db_system - DB システムの詳細情報を取得します。
• list_db_nodes - コンパートメント内の DB ノードを表示します（オプションで DB システムでフィルタリング可能）。
• get_db_node - DB ノードの詳細情報を取得します。
• start_db_node - 停止している DB ノードを起動します。
• stop_db_node - 実行中の DB ノードを停止します（ソフト停止またはハード停止）。
• reboot_db_node - DB ノードを再起動します。
• reset_db_node - DB ノードをリセット（強制再起動）します。
• softreset_db_node - DB ノードをソフトリセット（正常な再起動）します。
• start_db_system - DB システムのすべてのノードを起動します。
• stop_db_system - DB システムのすべてのノードを停止します。

💡 使用例

プロファイル管理

# Claude または任意の 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"

コンピュートインスタンスの管理

# インスタンスを表示
"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"

データベースシステムの管理

# DB システムを表示
"Show me all DB Systems in compartment ocid1.compartment.oc1..."

# DB システムの詳細を取得
"Get details for DB System ocid1.dbsystem.oc1..."

# DB ノードを管理
"List all DB Nodes for DB System ocid1.dbsystem.oc1..."
"Start DB Node ocid1.dbnode.oc1..."
"Stop all nodes of DB System ocid1.dbsystem.oc1..."

# 再起動操作
"Reboot DB Node ocid1.dbnode.oc1..."
"Soft reset DB Node ocid1.dbnode.oc1..."

リソースの探索

# コンパートメントを表示
"List all compartments in my tenancy"

# クロスリソースクエリ
"Show me all running instances in compartment X"
"List all DB Systems and their current states"

🚀 最近の改善点

v1.5 - 動的プロファイル選択（最新） 🔥

• マルチテナンシー対応：サーバーを再起動することなく、OCI プロファイルを切り替えることができます。
• 新しい MCP ツール: list_oci_profiles, set_oci_profile, get_current_oci_profile
• すべての OCI ツールでプロファイル要件の検証が行われます。
• オプションの --profile 引数（遅延初期化）
• DYNAMIC_PROFILE_SELECTION.md に完全なドキュメントが記載されています。
• 正確なツール一覧が記載された README が更新されました。

v1.4 - 集中管理された設定

• すべての設定定数が記載された集中管理された config.py が作成されました。
• コードベース全体のマジックナンバーが削除されました。
• 設定値の保守性と発見性が向上しました。

v1.3 - 非同期操作

• すべてのブロッキング time.sleep() 呼び出しが削除されました。
• すべての操作が本当に非同期になりました。
• サーバーの応答性が向上しました。

v1.2 - 標準化されたエラーハンドリング

• ハイブリッドエラーハンドリングパターンが実装されました。
• 技術的なエラー → 例外を発生させます。
• ビジネス状態 → 成功ディクショナリを返します。
• ERROR_HANDLING_PATTERN.md に詳細なドキュメントが記載されています。

v1.1 - DRY 原則

• mcp_tool_wrapper デコレータが作成されました。
• 約 150 行の重複コードが削除されました。
• すべてのツールで一貫したエラーハンドリングとロギングが行われます。

v1.0 - コードのクリーンアップ

• 未使用/古いファイルが削除されました。
• コメントアウトされたコードがクリーンアップされました。
• クリーンなベースラインが確立されました。

📚 ドキュメント

• Dynamic Profile Selection Guide - マルチテナンシー対応の完全なガイド
• Error Handling Pattern - エラーハンドリングの開発者ガイド
• Error Handling Examples - 実用的な例

🤝 コントリビューション

コントリビューションは歓迎されます！コードベースは以下のパターンに従っています。

• ハイブリッドエラーハンドリング（技術的なエラーでは例外を発生させ、ビジネス状態では辞書を返す）
• 非同期操作（ブロッキング呼び出しなし）
• 集中管理された設定（config.py の定数）
• DRY 原則（共通パターンにはデコレータを使用）

📝 ライセンス

[Add your license here]