MinIO モデルコンテキスト プロトコル (MCP)
このプロジェクトは、MinIOオブジェクトストレージ用のモデルコンテキストプロトコル（MCP）サーバーとクライアントを実装します。MinIOとやり取りするための標準化された方法を提供します。
特徴
サーバ
リソース
Resourcesを通じてMinIOデータを公開します。サーバーは以下のものにアクセスし、提供することができます。
テキストファイル（ファイル拡張子に基づいて自動的に検出されます）
バイナリ ファイル (application/octet-stream として処理)
バケットの内容（バケットあたり最大 1000 個のオブジェクト）
ツール
リストバケット
リクエストの認証された送信者が所有するすべてのバケットのリストを返します。
オプションパラメータ:
start_after(ページ区切り)、max_buckets(結果の制限)
リストオブジェクト
各リクエストごとにバケット内のオブジェクトの一部またはすべて（最大 1,000 個）を返します。
必須パラメータ:
bucket_nameオプションパラメータ:
prefix(プレフィックスでフィルタリング)、max_keys(結果の制限)
GetObject
MinIOからオブジェクトを取得します
必須パラメータ:
bucket_name、object_name
オブジェクトを配置する
fputメソッドを使用してMinIOバケットにファイルをアップロードします
必須パラメータ:
bucket_name、object_name、file_path
クライアント
このプロジェクトには複数のクライアント実装が含まれています。
基本クライアント- MinIO MCP サーバーと直接対話するためのシンプルなクライアント
Anthropic Client - MinIO との AI を活用したインタラクションを実現する Anthropic の Claude モデルとの統合
Related MCP server: MCP File Server
インストール
リポジトリをクローンします。
pip を使用して依存関係をインストールします。
またはuvを使用します:
環境設定
次の構成でルート ディレクトリに.envファイルを作成します。
使用法
サーバーの実行
サーバーは直接実行できます:
ベーシッククライアントの使用
Anthropicクライアントの使用
src/client/servers_config.jsonでサーバーを構成します。
クライアントを実行します。
アシスタントと対話する:
アシスタントは利用可能なツールを自動的に検出します
MinIOデータについて質問することができます
アシスタントは適切なツールを使用して情報を取得します
セッションを終了します:
セッションを終了するには、
quitまたはexitと入力します。
Claude Desktopとの統合
この MCP サーバーを Claude Desktop と統合できます。
構成
MacOSの場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
発達
プロジェクト構造
テストの実行
コードのフォーマット
デバッグ
MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、MCP Inspectorの使用をお勧めします。
起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。