快速启动 Auto MCP：一站式 Claude 桌面版和 Cursor

English | 한국어

介绍

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

主要优势：

1. 快速设置：只需运行工具并复制/粘贴生成的 JSON 文件，即可为 Claude 桌面版和 Cursor 添加 MCP 功能。
2. 提供多种工具：我们持续更新有用的 MCP 工具。通过关注我们来保持您的个性化工具包最新。 :)

目录

• 功能
• 项目结构
• 要求
• 安装
• 配置
• 使用方法
• 故障排除
• 许可证
• 贡献
• 联系
• 作者

功能

• RAG（检索增强生成） - 对 PDF 文档的关键字、语义和混合搜索功能
• Dify 外部知识 API - 通过 Dify 的外部知识 API 进行文档搜索功能
• Dify 工作流 - 执行并从 Dify 工作流中获取结果
• 网络搜索 - 使用 Tavily API 进行实时网络搜索
• 自动 JSON 生成 - 自动生成 Claude 桌面版和 Cursor 所需的 MCP JSON 文件

项目结构

.
├── case1                     # RAG example
├── case2                     # Dify External Knowledge API example
├── case3                     # Dify Workflow example
├── case4                     # Web Search example
├── data                      # Example data files
├── docs                      # Documentation folder
│   ├── case1.md           # case1 description 🚨 Includes tips for optimized tool invocation
│   ├── case2.md           # case2 description
│   ├── case3.md           # case3 description
│   ├── case4.md           # case4 description
│   └── installation.md    # Installation guide
├── .env.example              # .env example format
├── pyproject.toml            # Project settings
├── requirements.txt          # Required packages list
└── 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。

配置所需环境变量的站点

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

使用方法

1. 生成 JSON 文件

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

# Activate virtual environment

# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

# Navigate to example directory
cd case1

# Generate JSON file
python auto_mcp_json.py

2. 在 Claude 桌面版/Cursor 中注册 MCP

1. 启动 Claude 桌面版或 Cursor
2. 打开 MCP 设置菜单
3. 复制并粘贴生成的 JSON 内容
4. 保存并重启

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

故障排除

常见问题及解决方案：

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

许可证

MIT LICENSE

贡献

我们始终欢迎贡献！请通过提交问题或拉取请求参与项目。 :)

联系方式

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

作者

Hantaek Lim