rag-mcp

基于 FastMCP 的 RAG 服务，通过标准 MCP 协议对外暴露文档检索能力。

已支持工具：

• rag_rebuild_index — 索引指定目录的文档

• rag_index_status — 查看当前索引状态

• rag_search — 关键词 / 向量搜索

• rag_read_resource — 读取资源内容（rag://... URI）

说明：hybrid / rerank 为预留模式，尚未实现。

安装

uv sync

Related MCP server: ragi

配置

cp .env.example .env
# 编辑 .env，至少填入 EMBEDDING_API_KEY（vector 搜索必需）

核心环境变量：

运行

stdio 模式（默认，供 MCP 客户端接入）

uv run python main.py

SSE 模式（HTTP 服务，供调试或 Web 客户端使用）

MCP_TRANSPORT=sse uv run python main.py

验证：

curl http://127.0.0.1:8787/health
# {"status": "ok"}

MCP 端点：http://127.0.0.1:8787/mcp

资源访问端点：http://127.0.0.1:8787/resource?uri=rag://...

接入 Claude Desktop

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "rag-mcp": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "/path/to/rag_mcp"
    }
  }
}

典型用法

1. 调用 rag_rebuild_index，传入文档目录路径（支持 .md / .txt / .pdf）

2. 调用 rag_search，指定查询词和模式（keyword 或 vector）

3. 通过 rag_read_resource 读取搜索结果中的资源 URI

测试

uv run pytest -q