Minio Python MCP

🚀 MinIO モデルコンテキストプロトコル（MCP）

このプロジェクトは、MinIO オブジェクトストレージのモデルコンテキストプロトコル (MCP) サーバーとクライアントを実装しています。MinIO との標準的なやり取り方法を提供します。

✨ 主な機能

サーバー

リソース

リソース を通じて MinIO データを提供します。サーバーは以下のデータにアクセスして提供できます。

• テキストファイル（ファイル拡張子に基づいて自動検出）
• バイナリファイル（application/octet-stream として処理）
• 各バケットの内容（各バケットの最大表示オブジェクト数は 1000）

ツール

• バケットの一覧表示

  • 認証された送信者が所有し、リクエストを送信したすべてのバケットのリストを返します。
  • オプションパラメータ：start_after（ページング用）、max_buckets（結果数の制限）

• オブジェクトの一覧表示

  • 特定のバケット内の一部または全て（最大 1000）のオブジェクトを返します。各リクエストで一定数のオブジェクトが返されます。
  • 必須パラメータ：bucket_name
  • オプションパラメータ：prefix（接頭辞でのフィルタリング）、max_keys（結果数の制限）

• オブジェクトの取得

  • MinIO からオブジェクトを取得します。
  • 必須パラメータ：bucket_name、object_name

• オブジェクトのアップロード

  • fput メソッドを使用して、ファイルを MinIO バケットにアップロードします。
  • 必須パラメータ：bucket_name、object_name、file_path

クライアント

このプロジェクトには複数のクライアント実装が含まれています。

1. 基本クライアント - MinIO MCP サーバーと直接やり取りするためのシンプルなクライアント
2. Anthropic クライアント - Anthropic の Claude モデルと統合され、AI 駆動の MinIO インタラクション機能を提供します。

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/yourusername/minio-mcp.git
cd minio-mcp

2. pip を使用して依存関係をインストールします：

pip install -r requirements.txt

または uv を使用します：

uv pip install -r requirements.txt

📚 環境設定

ルートディレクトリに .env ファイルを作成し、以下の設定を含めます。

# MinIO 設定
MINIO_ENDPOINT=play.min.io
MINIO_ACCESS_KEY=your_access_key
MINIO_SECRET_KEY=your_secret_key
MINIO_SECURE=true
MINIO_MAX_BUCKETS=5

# サーバー設定
SERVER_HOST=0.0.0.0
SERVER_PORT=8000

# Anthropic クライアントを使用する場合
ANTHROPIC_API_KEY=your_api_key

💻 使用例

サーバーの起動

MCP サーバーを起動するには、以下のコマンドを実行します。

python -m minio_mcp_server.main

基本クライアント

基本クライアントは以下のインターフェースを提供します。

• list_buckets()
• list_objects(bucket_name, prefix=None, max_keys=1000)
• get_object(bucket_name, object_name)
• put_object(bucket_name, object_name, file_path)

Anthropic クライアント

Anthropic クライアントを使用するには、まず Anthropic ライブラリをインストールします。

pip install anthropic

次に、環境変数 ANTHROPIC_API_KEY を設定し、Anthropic ドキュメント を参照して機能を使用します。

🔧 開発

プロジェクト構造

minio_mcp/
├── server/
│   ├── main.py          # MCP サーバーのメインプログラム
│   └── utils.py        # 補助関数とツール
├── client/
│   ├── basic_client.py  # 基本クライアントの実装
│   └── anthropic_client.py  # Anthropic クライアントの実装
└── config/             # 設定ファイルと環境変数の処理
    └── settings.py     # アプリケーションの設定

テストの実行

MCP サーバーのテストを実行するには、以下のコマンドを実行します。

python -m pytest tests/

コードフォーマット

コードの一貫性と可読性を維持するために、以下のツールを使用します。

• black でコードをフォーマット
• isort でインポート文を並べ替え
• flake8 でコードスタイルとエラーをチェック

これらのツールをインストールします。

pip install black isort flake8

フォーマットとチェックを実行します。

black .
isort .
flake8

デバッグ

MCP サーバーは標準入力/出力を通じて動作するため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP インスペクターを使用することをおすすめします。

npx @modelcontextprotocol/inspector python path/to/minio-mcp/src/minio_mcp_server/server.py

起動後、インスペクターは URL を表示します。この URL をブラウザで開いてデバッグを開始できます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。