Inicio rápido Auto MCP: Todo en uno Claude Desktop y Cursor

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. :)

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. :)

Contacto

Si tiene preguntas o necesita ayuda, registre un problema o comuníquese con: dev@brain-crew.com

Autor

Hantaek Lim

Integrations