Chromadb Fastapi Mcp

安装

1. 克隆仓库
2. 安装依赖:

   uv sync
   

3. 复制 .env.example 到 .env 并配置设置:

   cp .env.example .env
   

4. 编辑 .env 文件，设置你偏好的配置

配置

在你的 .env 文件中配置以下环境变量:

• CHROMA_CLIENT_TYPE: ephemeral 或 persistent
• CHROMA_DATA_DIR: 当使用持久化客户端时，用于存储的目录
• OPENAI_API_KEY: 你的 OpenAI API 密钥，用于 embeddings

使用

运行服务器:

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 接口

集合 (Collections)

• 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} - 删除一个集合

文档 (Documents)

• 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 服务器

一旦你的带有 MCP 集成的 FastAPI 应用运行起来，你可以使用任何支持 SSE 的 MCP 客户端连接到它，例如 Cursor:

1. 运行你的应用。

2. 在 Cursor -> Settings -> MCP 中，使用你的 MCP 服务器端点的 URL (例如, http://localhost:8000/mcp) 作为 sse。

3. Cursor 将会自动发现所有可用的工具和资源。

使用 mcp-proxy stdio 连接到 MCP 服务器

如果你的 MCP 客户端不支持 SSE，例如 Claude Desktop:

1. 运行你的应用。

2. 安装 mcp-proxy, 例如: uv tool install mcp-proxy。

3. 在 Claude Desktop MCP 配置文件 (claude_desktop_config.json) 中添加:

在 Windows 上:

{
  "mcpServers": {
    "my-api-mcp-proxy": {
        "command": "mcp-proxy",
        "args": ["http://127.0.0.1:8000/mcp"]
    }
  }
}

在 MacOS 上:

通过在终端运行 which mcp-proxy 找到 mcp-proxy 的路径。

{
  "mcpServers": {
    "my-api-mcp-proxy": {
        "command": "/Full/Path/To/Your/Executable/mcp-proxy",
        "args": ["http://127.0.0.1:8000/mcp"]
    }
  }
}

通过在终端运行 which uvx 找到 mcp-proxy 的路径。

{
  "mcpServers": {
    "my-api-mcp-proxy": {
        "command": "/Full/Path/To/Your/uvx",
        "args": ["mcp-proxy", "http://127.0.0.1:8000/mcp"]
    }
  }
}

4. Claude Desktop 将会自动发现所有可用的工具和资源。