MCP Milvus

🚀 MCP Milvus

Model Context Protocol (MCP) のサーバーであり、Milvusベクトルデータベースに対応しており、包括的なベクトルデータベース操作を提供します。

✨ 主な機能

• 完全なMilvus操作：データベース、コレクション、インデックスの完全なライフサイクル管理
• 高性能ベクトル検索：類似性検索、ハイブリッド検索などのさまざまな検索方法をサポート
• インテリジェントセッション管理：Ristrettoキャッシュに基づく効率的なコネクションプーリング
• エンジニアリングアーキテクチャ：拡張とメンテナンスが容易なモジュール化設計
• ミドルウェアサポート：ロギング、認証などのミドルウェアが組み込まれています
• Dockerサポート：完全なコンテナ化されたデプロイメントソリューション
• 型安全性：Goの強力な型システムにより、APIの安全性が保証されます

📋 サポートされるツール

データベース管理

• milvus_create_database - データベースを作成
• milvus_list_databases - すべてのデータベースをリスト表示
• milvus_use_database - データベースを切り替え

コレクション管理

• milvus_create_collection - コレクションを作成
• milvus_drop_collection - コレクションを削除
• milvus_list_collections - コレクションをリスト表示
• milvus_get_collection_info - コレクション情報を取得
• milvus_rename_collection - コレクションをリネーム
• milvus_load_collection - コレクションをメモリにロード
• milvus_release_collection - コレクションをメモリから解放

インデックス管理

• milvus_create_index - インデックスを作成
• milvus_drop_index - インデックスを削除

データ操作

• milvus_insert_data - データを挿入
• milvus_upsert - データを挿入または更新
• milvus_delete_entities - エンティティを削除
• milvus_query - 条件付きクエリ
• milvus_vector_search - ベクトル類似性検索

接続管理

• milvus_connector - Milvus接続を確立

📦 インストール

前提条件

• Go 1.24以上
• 稼働中のMilvusインスタンス

ソースからインストール

git clone https://github.com/tailabs/mcp-milvus.git
cd mcp-milvus
make deps
make build

または、直接Goを使用してインストールすることもできます。

git clone https://github.com/tailabs/mcp-milvus.git
cd mcp-milvus
go mod download
go build -o mcp-milvus ./cmd/mcp-milvus

Dockerデプロイメント

# イメージをビルド
docker build -t mcp-milvus .

# コンテナを実行
docker run -p 8080:8080 mcp-milvus

💻 使用例

基本的な使用法

1. サーバーを起動

# Makefileを使用する場合
make run

# または直接実行
./build/mcp-milvus

2. Milvusに接続 milvus_connector ツールを使用して接続を確立します。

{
  "address": "localhost:19530",
  "token": "username:password",
  "db_name": "default"
}

3. 操作を実行 接続が確立されたら、他のツールを使用してデータベース操作を行うことができます。

📚 ドキュメント

プロジェクト構造

mcp-milvus/
├── cmd/mcp-milvus/          # メインアプリケーションエントリー
├── internal/
│   ├── middleware/          # ミドルウェア（ロギング、認証など）
│   ├── registry/            # ツールレジストリ
│   ├── schema/              # スキーマビルダー
│   ├── session/             # セッション管理
│   └── tools/               # Milvusツールの実装
├── Dockerfile               # Dockerビルドファイル
├── go.mod                   # Goモジュール定義
└── README.md               # プロジェクトドキュメント

設定

環境変数

• LOG_LEVEL：ログレベル（debug/info/warn/error）、デフォルト: info
• PORT：サービスポート、デフォルト: 8080

接続設定

以下の接続パラメータをサポートしています。

• address：Milvusサービスアドレス
• token：認証トークン（形式: username:password）
• db_name：データベース名

🤝 コントリビューション

すべての形態のコントリビューションを歓迎します！詳細は CONTRIBUTING.md を参照してください。

開発ワークフロー

1. このリポジトリをフォークする
2. 新しい機能ブランチを作成する (git checkout -b feature/AmazingFeature)
3. 開発環境をセットアップする (make deps && make tools)
4. 変更を加えてテストする (make test && make lint)
5. 変更をコミットする (git commit -m 'Add some AmazingFeature')
6. ブランチにプッシュする (git push origin feature/AmazingFeature)
7. プルリクエストを作成する

利用可能なMakeコマンド

すべての利用可能なコマンドを表示するには、make help を実行します。

make help          # すべての利用可能なコマンドを表示
make build         # バイナリをビルド
make test          # テストを実行
make lint          # リンターを実行
make fmt           # コードをフォーマット
make run           # ビルドして実行
make dev           # ライブリロードで実行
make docker        # Dockerイメージをビルド
make build-all     # すべてのプラットフォーム向けにビルド
make release       # リリースを準備
make clean         # ビルドアーティファクトをクリーンアップ

📄 ライセンス

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

🔗 関連リンク

• Milvus公式ウェブサイト
• Model Context Protocol
• MCP Go SDK

📞 サポート

問題が発生した場合や質問がある場合は、以下の手順を行ってください。

1. Issues を確認して、同様の問題が存在するかを確認
2. 問題を説明して新しいIssueを作成
3. Discussionsで議論に参加

🙏 謝辞

• Milvus - 優れたベクトルデータベース
• MCP Go - MCPのGo実装
• すべての貢献者とユーザー

⭐ このプロジェクトが役に立った場合は、スターを付けてください！