快速启动 Auto MCP：集 Claude Desktop 和 Cursor 于一体的工具

English | 한국어

简介

快速启动 Auto MCP 是一个工具，旨在帮助您轻松快速地在 Claude Desktop 和 Cursor 中注册 Anthropic 的模型上下文协议 (MCP)。

主要优势：

1. 快速设置：只需运行一个工具并复制/粘贴生成的 JSON 文件，即可将 MCP 功能添加到 Claude Desktop 和 Cursor。
2. 提供各种工具：我们会不断更新有用的 MCP 工具。请通过加星标和关注我们，及时了解您的个性化工具包。:)

目录

• 功能
• 项目结构
• 要求
• 安装
• 配置
• 使用
• 问题排查
• 许可
• 贡献
• 联系方式
• 作者

功能

• RAG（检索增强生成） - PDF 文档的关键词、语义和混合搜索功能
• Dify 外部知识 API - 通过 Dify 的外部知识 API 实现文档搜索功能
• Dify 工作流 - 执行并检索 Dify 工作流的结果
• 网页搜索 - 使用 Tavily API 进行实时网页搜索
• 自动 JSON 生成 - 自动生成 Claude Desktop 和 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 Desktop 或 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。

配置每个案例所需环境变量的网站

• https://platform.openai.com/api-keys
• https://dify.ai/
• https://app.tavily.com/home

使用

1. 生成 JSON 文件

在每个案例目录中运行以下命令以生成必要的 JSON 文件：

# 激活虚拟环境

# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

# 导航到示例目录
cd case1

# 生成 JSON 文件
python auto_mcp_json.py

2. 在 Claude Desktop/Cursor 中注册 MCP

1. 启动 Claude Desktop 或 Cursor
2. 打开 MCP 设置菜单
3. 复制并粘贴生成的 JSON 内容
4. 保存并重启（如果您使用的是 Windows，我们建议通过任务管理器完全关闭该进程，然后重新启动应用程序。）

注意：当您运行 Claude Desktop 或 Cursor 时，MCP 服务器将自动随之运行。当您关闭软件时，MCP 服务器也将终止。

问题排查

常见问题和解决方案：

• MCP 服务器连接失败：检查服务是否正常运行，以及是否存在端口冲突。特别是，在应用 case2 时，您还必须运行 dify_ek_server.py。
• API 密钥错误：验证环境变量是否设置正确。
• 虚拟环境问题：确保 Python 版本为 3.11 或更高版本。

许可

MIT LICENSE

贡献

欢迎随时贡献！请通过问题注册或拉取请求参与项目。:)

联系方式

如果您有任何问题或需要帮助，请注册一个 issue 或联系： dev@brain-crew.com

作者

Hantaek Lim