Inicio rápido Auto MCP: Todo en uno Claude Desktop y Cursor
Inglés | Coreano
Introducción
Quick-start Auto MCP es una herramienta que le ayuda a registrar de manera fácil y rápida el Protocolo de contexto de modelo (MCP) de Anthropic en Claude Desktop y Cursor.
Ventajas clave:
- Configuración rápida : agregue la funcionalidad MCP a Claude Desktop y Cursor simplemente ejecutando una herramienta y copiando/pegando el archivo JSON generado.
- Diversas herramientas disponibles : Actualizamos constantemente herramientas útiles de MCP. Manténgase al día con su kit de herramientas personalizado marcándonos con una estrella y siguiéndonos. :)
Tabla de contenido
Características
- RAG (Recuperación de Generación Aumentada) : funcionalidad de búsqueda por palabras clave, semántica e híbrida para documentos PDF
- API de conocimiento externo de Dify : funcionalidad de búsqueda de documentos a través de la API de conocimiento externo de Dify
- Flujo de trabajo de Dify : ejecutar y recuperar resultados de Dify Workflow
- Búsqueda web : búsqueda web en tiempo real mediante la API de Tavily
- Generación automática de JSON : genere automáticamente los archivos JSON de MCP necesarios para Claude Desktop y Cursor
Estructura del proyecto
.
├── 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
Requisitos
- Python >= 3.11
- Claude Desktop o Cursor (versión compatible con MCP)
- uv (recomendado) o pip
Instalación
1. Clonar el repositorio
git clone https://github.com/teddynote-lab/mcp.git
cd mcp
2. Configurar el entorno virtual
Uso de uv (recomendado)
# macOS/Linux
uv venv
uv pip install -r requirements.txt
# Windows
uv venv
uv pip install -r requirements_windows.txt
Usando 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. Preparación del archivo PDF
Prepare el archivo PDF necesario para RAG en el directorio ./data .
Configuración
Para ejecutar cada caso, se requiere un archivo .env . Especifique las variables de entorno necesarias en el archivo .env.example , ubicado en el directorio raíz, y renómbrelo como .env .
sitios para configurar las variables de entorno requeridas para cada caso
Uso
1. Generar archivo JSON
Ejecute el siguiente comando en cada directorio de caso para generar el archivo JSON necesario:
# 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. Registrar MCP en Claude Desktop/Cursor
- Inicie Claude Desktop o Cursor
- Abrir el menú de configuración de MCP
- Copia y pega el contenido JSON generado
- Guardar y
restart
Nota : Al ejecutar Claude Desktop o Cursor, el servidor MCP se ejecutará automáticamente. Al cerrar el software, el servidor MCP también se cerrará.
Solución de problemas
Problemas comunes y soluciones:
- Fallo de conexión al servidor MCP : Compruebe si el servicio funciona correctamente y si no hay conflictos de puertos. En particular, al aplicar el caso 2, también debe ejecutar
dify_ek_server.py . - Errores de clave API : Verifique que las variables de entorno estén configuradas correctamente.
- Problemas del entorno virtual : asegúrese de que la versión de Python sea 3.11 o superior.
Licencia
LICENCIA MIT
Contribuyendo
¡Las contribuciones siempre son bienvenidas! Por favor, participa en el proyecto mediante el registro de problemas o solicitudes de incorporación de cambios. :)
Si tiene preguntas o necesita ayuda, registre un problema o comuníquese con: dev@brain-crew.com
Autor
Hantaek Lim