MCP用例服务器
项目介绍
快速启动自动MCP：Claude桌面和Cursor的一站式解决方案
简介
快速启动自动MCP 是一个帮助您轻松快速地在Claude桌面和Cursor中注册Anthropic的模型上下文协议（MCP）的工具。
主要优势：
- 快速设置：只需运行一个工具并复制/粘贴生成的JSON文件即可为Claude桌面和Cursor添加MCP功能。
- 提供多种工具：我们持续更新有用的MCP工具。通过关注和跟随我们来保持您的个性化工具集最新。:)
目录
特性
- RAG（检索增强生成） - 对PDF文档进行关键词、语义和混合搜索的功能
- Dify外部知识API - 通过Dify的外部知识API进行文档搜索的功能
- Dify工作流 - 执行并从Dify工作流中检索结果
- 网络搜索 - 使用Tavily API进行实时网络搜索
- 自动JSON生成 - 自动生成用于Claude桌面和Cursor所需的MCP JSON文件
项目结构
.
├── case1 # RAG示例
├── case2 # Dify外部知识API示例
├── case3 # Dify工作流示例
├── case4 # 网络搜索示例
├── data # 示例数据文件
├── docs # 文档文件夹
│ ├── case1.md # case1描述 🚨 包含优化工具调用的提示
│ ├── case2.md # case2描述
│ ├── case3.md # case3描述
│ ├── case4.md # case4描述
│ └── installation.md # 安装指南
├── .env.example # .env示例格式
├── pyproject.toml # 项目设置
├── requirements.txt # 需要的包列表
└── uv.lock # uv.lock
需求
- Python >= 3.11
- Claude桌面或Cursor（支持MCP的版本）
- uv（推荐）或pip
安装
1. 克隆仓库
git clone https://github.com/teddynote-lab/mcp.git
cd mcp
2. 设置虚拟环境
使用uv（推荐）
# macOS/Linux
uv venv
uv pip install -r requirements.txt
# Windows
uv venv
uv pip install -r requirements_windows.txt
使用pip
python -m venv .venv
# Windows
.venv\Scripts\activate
pip install -r requirements_windows.txt
# macOS/Linux
source .venv/bin/activate
pip install -r requirements.txt
3. 准备PDF文件
请在./data目录下准备用于RAG的PDF文件。
配置
为了执行每个案例，需要一个.env文件。
请在根目录中的.env.example文件中指定必要的环境变量，并将其重命名为.env。
各案例所需环境变量的配置网站
使用方法
1. 生成JSON文件
在每个案例目录中运行以下命令以生成所需的JSON文件：
# 激活虚拟环境
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# 导航到示例目录
cd case1
# 生成JSON文件
python auto_mcp_json.py
2. 在Claude桌面/Cursor中注册MCP
- 启动Claude桌面或Cursor
- 打开MCP设置菜单
- 复制并粘贴生成的JSON内容
- 保存并
重启（如果您使用的是Windows，建议通过任务管理器完全关闭进程，然后重新启动应用程序。）
注意：当您运行Claude桌面或Cursor时，MCP服务器会自动与其一起运行。当您关闭软件时，MCP服务器也会终止。
故障排除
常见问题及解决办法：
- MCP服务器连接失败：检查服务是否正常运行且没有端口冲突。特别是应用case2时，还必须运行
dify_ek_server.py。 - API密钥错误：验证环境变量是否设置正确。
- 虚拟环境问题：确保Python版本为3.11或更高。
许可证
贡献
欢迎贡献！请通过注册问题或拉取请求参与项目。:)
联系
如果您有任何疑问或需要帮助，请注册一个问题或联系： dev@brain-crew.com