Chromadb Fastapi MCP

🚀 クイックスタート

このプロジェクトは、特定の機能を提供するアプリケーションです。以下の手順に従って、インストール、設定、使用を行うことができます。

📦 インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   uv sync
   

3. .env.example を .env にコピーし、設定を構成します。

   cp .env.example .env
   

4. 好みの設定で .env を編集します。

📚 ドキュメント

設定

.env ファイルで以下の環境変数を設定します。

使用例

基本的な使用法

サーバーを起動します。

cd /path/to/chromadb-fastapi-mcp
uv run python -m app.main

または、直接 uvicorn を使用します。

uv run uvicorn app.main:app --reload

サーバーは http://localhost:8000 で起動し、API ドキュメントは http://localhost:8000/docs で確認できます。

API エンドポイント

コレクション

• GET /api/collections/ - すべてのコレクションをリストします。
• POST /api/collections/ - 新しいコレクションを作成します。
• GET /api/collections/{collection_name}/peek - コレクション内の内容の概要を表示します。
• GET /api/collections/{collection_name}/info - コレクションの情報を取得します。
• GET /api/collections/{collection_name}/count - コレクション内のドキュメント数を取得します。
• PUT /api/collections/{collection_name} - コレクションを変更します。
• DELETE /api/collections/{collection_name} - コレクションを削除します。

ドキュメント

• POST /api/documents/add - コレクションにドキュメントを追加します。
• POST /api/documents/query - コレクションからドキュメントをクエリします。
• POST /api/documents/get - コレクション内のドキュメントを取得します。
• PUT /api/documents/update - コレクション内のドキュメントを更新します。
• DELETE /api/documents/delete - コレクション内のドキュメントを削除します。

MCP サーバー

https://github.com/tadata-org/fastapi_mcp

SSE を使用して MCP サーバーに接続する

FastAPI アプリケーションを実行した後：

1. Cursor -> 設定 -> MCP で、MCP サーバーのエンドポイント URL (例: http://localhost:8000/mcp) を sse として使用します。
2. Cursor は自動的に利用可能なすべてのツールとリソースを検出します。

mcp-proxy stdio を使用して MCP サーバーに接続する

Claude Desktop で設定します。

1. mcp-proxy をインストールします。

   pip install mcp-proxy
   

2. ターミナルで以下のコマンドを実行して、設定ファイルを作成します。

   python -m mcp_proxy.start_server
   

3. ~/.config/mcp_proxy/config.json ファイルを変更し、モデルのエンドポイント情報を追加します。
4. Claude アプリを使用して MCP サーバーに接続します。