MCP with RAG Demo
2025.04.12
0
Python模型交互知识库管理开发效率
MCP with RAG Demo 是一个展示如何实现具有检索增强生成（RAG）能力的模型上下文协议（MCP）服务器的演示项目。该项目允许AI模型与知识库交互，搜索信息并添加新文档。
View on GitHub
Overview
基本能力
产品定位
MCP with RAG Demo 是一个用于展示MCP服务器与RAG技术结合的演示项目，旨在展示AI模型如何与知识库交互。
核心功能
- 支持工具和资源的MCP服务器
- 实现检索增强生成（RAG）功能（支持内存存储回退）
- 提供与MCP服务器交互的客户端示例
- 支持SSE（HTTP）和stdio两种通信模式
- 简单的提示模板
适用场景
- AI模型与知识库的交互
- 信息检索与增强生成
- 开发MCP服务器的示例和测试
工具列表
echo: 回显提供的消息add: 两个数字相加add_document: 向知识库添加文档rag_search: 在知识库中搜索相关信息list_documents: 列出知识库中的所有文档
常见问题解答
- 客户端连接问题: 确保服务器正在运行，使用正确的URL，服务器监听正确的接口
- 服务器端点问题: MCP服务器在
/sse暴露SSE端点，客户端会自动补全URL - 调试模式: 使用
--debug参数启用详细输出 - 导入错误: 确保安装了所有依赖项，特别是
mcp-sdk
使用教程
使用依赖
- Python 3.8+
- pip (Python包管理器)
安装教程
- 克隆仓库:
git clone <repository-url>
cd mcp-demo
- 创建虚拟环境:
python -m venv mcp-env
source mcp-env/bin/activate # Windows: mcp-env\Scripts\activate
- 安装依赖:
pip install -r requirements.txt
调试方式
- 启动MCP服务器:
- SSE模式:
bash python server.py --sse - stdio模式:
bash python server.py --stdio - 运行客户端示例:
- 连接SSE服务器:
bash python client_example.py --sse http://localhost:8000 - 连接stdio服务器:
bash python client_example.py --stdio --command python --args "server.py --stdio" - 调试命令:
python client_example.py --sse http://localhost:8000 --debug