Mcp Milvus

MCP Milvus

Milvus ベクトルデータベース向けの Model Context Protocol (MCP) サーバーです。包括的なベクトルデータベース操作を提供します。

🚀 特長

• 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 によるデプロイ

# Build image
docker build -t mcp-milvus .

# Run container
docker run -p 8080:8080 mcp-milvus

使用方法

1. サーバーを起動する

# Using Makefile
make run

# Or directly
./build/mcp-milvus

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

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

3. 操作を実行する 接続が確立したら、ほかのツールを使用してデータベースを操作できます。

🏗️ プロジェクト構成

mcp-milvus/
├── cmd/mcp-milvus/          # Main application entry
├── internal/
│   ├── middleware/          # Middleware (logging, auth, etc.)
│   ├── registry/            # Tool registry
│   ├── schema/              # Schema builder
│   ├── session/             # Session management
│   └── tools/               # Milvus tool implementations
├── Dockerfile               # Docker build file
├── go.mod                   # Go module definition
└── README.md               # Project documentation

🔧 設定

環境変数

• 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          # Show all available commands
make build         # Build binary
make test          # Run tests
make lint          # Run linter
make fmt           # Format code
make run           # Build and run
make dev           # Run with live reload
make docker        # Build Docker image
make build-all     # Build for all platforms
make release       # Prepare release
make clean         # Clean build artifacts

📝 ライセンス

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

🔗 関連リンク

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

📞 サポート

問題が発生した場合や質問がある場合は、次の手順をご確認ください：

1. 類似の問題がないか Issues を確認します
2. 問題の内容を説明する新しい Issue を作成します
3. Discussions で議論に参加します

🙏 謝辞

• Milvus - 優れたベクトルデータベース
• MCP Go - MCP の Go 実装
• すべてのコントリビューターとユーザー

---

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