检索增强生成服务器

一个轻量级、可分叉的RAG项目,提供MCP服务器(用于VS Code/Copilot)和最小化Web界面,支持自定义知识集索引与查询。

  • by NumericalPie
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 NumericalPie/KnowledgeMCPServer

使用说明

知识MCPServer

小型、可分叉的RAG项目,带有MCP服务器(用于VS代码/复制品)和最小的web UI。

快速开始

先决条件:安装 uv 从https://docs.astral.sh/uv/

uv sync
source .venv/bin/activate

运行测试:

uv run pytest

将其与您自己的知识集结合使用

  1. 从干净的数据状态开始(可选但推荐):
rm -f data/docs/* data/vectorstore/*
echo '{}' > data/metadata.json
  1. 指标内容:
uv run python -m knowledge_mcp_server.cli index --url https://example.com
# or --pdf /path/to/file.pdf
# or --tex /path/to/file.tex
  1. 通过MCP或HTTP/web UI查询。

在VS代码中注册MCP服务器

code --add-mcp '{"name":"knowledge-mcp-server","command":"uv","args":["run","python","-m","knowledge_mcp_server.mcp_stdio_server"],"cwd":"'$(pwd)'"}'

运行Web UI

uv run uvicorn knowledge_mcp_server.mcp_server:app --reload --port 8000

打开 http://127.0.0.1:8000/.

项目布局

  • 代码: src/knowledge_mcp_server/
  • 测验: tests/
  • 运行时数据: data/docs/, data/vectorstore/, data/metadata.json

默认值

  • 嵌入: all-MiniLM-L6-v2
  • 分块:800字,100个重叠
  • HTTP端口: 8000

文档

  • docs/MCP_SETUP.md -MCP注册和故障排除
  • docs/ARCHITECTURE.md -建筑说明

许可证

麻省理工学院(见 LICENSE)