🚀 chromadb-fastapi-mcp项目

本项目提供了一个基于FastAPI的服务，借助Chroma数据库进行文档管理，并可与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 密钥用于嵌入。

启动服务器

运行服务器：

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 查看。

📦 安装指南

依赖安装

uv sync

环境配置

复制 .env.example 到 .env 并进行编辑：

cp .env.example .env

💻 使用示例

基础用法

启动服务器：

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

高级用法

使用 uvicorn 启动并开启热重载：

uv run uvicorn app.main:app --reload

📚 详细文档

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

使用 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 服务器。