克劳德桌面版FAQ-RAG MCP服务器
一种模型上下文协议（MCP）服务器，使用RAG（检索增强生成）向Claude Desktop提供常见问题搜索功能。该项目使Claude能够搜索您的常见问题文档，并根据语义相似性提供相关答案。
灵感来自这里：https://www.youtube.com/watch?v=rnljvmHorQw
常见问题解答数据和代码取自此处：https://www.youtube.com/watch?v=W2EDdZplLcU
🚀 特性
- 常见问题搜索：通过语义相关性排名搜索数百个常见问题条目
- 实时集成：通过MCP协议直接与Claude Desktop配合使用
- 轻松设置：配置简单，依赖性最小
- Windows兼容的：针对Windows 10/11进行了测试和优化
📋 先决条件
- Python 3.8或更高版本
- Windows 10/11（Mac/Linux应该可以工作，但没有经过测试）
- Claude桌面应用程序
🛠️ 安装和设置
第一步：下载克劳德桌面
- 首选 Claude.ai 并下载克劳德桌面
- 在Windows计算机上安装Claude Desktop
- 创建帐户并登录
步骤2：克隆/下载此存储库
选项A：手动下载（推荐）
- 从此存储库下载所有文件
- 创建文件夹：
C:\mcp_projects\claude_desktop_FAQ_RAG_MCP\ - 将所有文件放置在此文件夹中
选项B:Git克隆
git clone https://github.com/denis911/RAG-MCP-server-for-local-Claude-desktop-app
cd claude_desktop_FAQ_RAG_MCP步骤3：安装Python依赖项
pip install fastmcp minsearch toyaikit或全局安装：
pip install --user fastmcp minsearch toyaikit注： 这 requests 库已导入 main.py 但实际上并没有使用，因为我们在本地加载文档。
步骤4：测试您的MCP服务器
首先，测试您的服务器是否正常运行：
cd C:\mcp_projects\claude_desktop_FAQ_RAG_MCP
python main.py您应该看到如下输出：
Starting MCP server 'Search FAQ'...
INFO: Started server process [XXXX]如果成功，请按 Ctrl+C 停止服务器。
步骤5：配置Claude桌面
- 查找您的Claude Desktop配置目录：
- 按 Win + R - 类型 %APPDATA%\Claude 然后按Enter键
- 创建配置文件：
- 查找名为的文件 claude_desktop_config.json 在Claude文件夹中 - 添加以下内容：
{
"mcpServers": {
"FAQ-RAG-MCP-server": {
"command": "python",
"args": ["C:\\mcp_projects\\claude_desktop_FAQ_RAG_MCP\\main.py"],
"cwd": "C:\\mcp_projects\\claude_desktop_FAQ_RAG_MCP",
"env": {
"PYTHONPATH": "C:\\mcp_projects\\claude_desktop_FAQ_RAG_MCP"
}
}
}
}⚠️ 重要提示： 如果路径不同，请用实际安装目录替换。
步骤6：重新启动克劳德桌面
- 完全关闭克劳德桌面 （不要只是关上窗户）
- 使用任务管理器(Ctrl + Shift + Esc) - 寻找“克劳德”流程并结束它们 - 或者右键单击系统托盘中的Claude图标并“退出”
- 重新启动克劳德桌面
- 等待15-30秒 以便MCP服务器初始化
步骤7：测试连接
- 寻找a 锤子/工具图标 或Claude Desktop中的“搜索和工具”按钮
- 点击查看可用工具
- 您应该看到列出的“常见问题解答RAG MCP服务器”
- 让Claude搜索您的FAQ数据库进行测试
🔧 故障排除
问题：“无可用工具”或工具按钮未出现
解决：
- 检查配置文件位置： 确保
claude_desktop_config.json在...里%APPDATA%\Claude\ - 验证JSON语法： 使用JSON验证器检查语法错误
- 尝试完整的Python路径：
where python在配置中使用完整路径：
"command": "C:\\Users\\YourName\\AppData\\Local\\Programs\\Python\\Python312\\python.exe"- 检查文件路径： 确保配置中的所有路径都正确，并使用双反斜杠(
\\)
问题：MCP服务器启动但立即断开连接
解决：
- 首先手动测试服务器：
python main.py- 检查缺少的依赖项：
pip show fastmcp minsearch toyaikit- 验证documents.json是否存在 与main.py位于同一目录中
问题：“请求超时”错误
解决：
- 减少文档加载时间 -FAQ数据库可能太大
- 首先使用简单的测试服务器：
python test_simple.py- 检查防病毒软件 -它可能会阻塞连接
问题：权限被拒绝或找不到文件错误
解决：
- 以管理员身份运行命令提示符
- 检查文件权限 在您的项目目录中
- 使用绝对路径 而不是配置中的相对路径
📁 文件结构
claude_desktop_FAQ_RAG_MCP/
├── main.py # Main MCP server with SearchTools integration
├── search_tools.py # FAQ search functionality and index management
├── test_simple.py # Simple test server for troubleshooting
├── documents.json # FAQ database (1000+ questions)
├── claude_desktop_config.json # Example configuration file
└── README.md # This file🎯 使用示例
连接后，您可以通过Claude与您的FAQ数据库进行交互：
示例1：技术问题
你问： “如何在Windows上安装Kafka？”
Claude搜索您的常见问题并回复： 数据库中的5个相关答案，按相关性排名，涵盖Docker设置、Python集成和故障排除。
示例2：学习资源
你问： “学习DBT最简单的方法是什么？”
克劳德提供： 信息结合互联网搜索结果、常见问题数据库答案以及自身知识，为全面的学习路径。
示例3：故障排除
你问： “我遇到Docker权限错误”
克劳德搜索： 您的常见问题数据库中有类似的问题，并提供其他用户经验的具体解决方案。
🎉 益处
- 即刻进入：立即搜索数百个常见问题条目
- 上下文答案：获取按相似性排序的相关答案
- 本地处理：您的数据保留在您的计算机上
- 可扩展：易于添加更多文档或修改搜索逻辑
- 整合：在Claude桌面界面中工作
📝 技术细节
- 框架：用于MCP协议实施的FastMCP
- 搜索引擎：使用AppendableIndex进行文档索引和检索的MinSearch
- 整合：toyakit.tools用于将SearchTools方法包装为MCP工具
- 运输：用于可靠Claude Desktop通信的默认MCP传输（stdio）
- 数据存储：基于JSON的FAQ存储，带有课程分类和元数据
- 搜索功能:
- 跨问题、文本和部分字段的语义搜索 - 课程筛选（当前设置为“数据工程zoomcamp”） - 增强权重（问题：3.0x，部分：0.5x） - 返回前5个最相关的结果-目前已硬编码，可以是任何需要的数字
🆘 获取帮助
如果你仍然有问题：
- 检查克劳德桌面日志 用于错误消息
- 首先使用简单服务器进行测试 (
test_simple.py) - 验证所有文件路径 配置正确
- 确保Python依赖关系 已正确安装
- 尝试不同的Python版本 如果出现兼容性问题
🏷️ 版本信息
- 经过测试：克劳德桌面v0.13.19
- python: 3.8+
- 平台：Windows 10/11（应适用于Mac/Linux）
______________________________________________________________________
搜索愉快！ 🔍 通过Claude Desktop，您的常见问题数据库现在触手可及。