Plantilla de servidor MCP para Cursor IDE

Una plantilla sencilla para crear herramientas personalizadas para Cursor IDE mediante el Protocolo de Contexto de Modelo (MCP). Cree su propio repositorio a partir de esta plantilla, modifique las herramientas y conéctelas a su Cursor IDE.

Inicio rápido

1. Haga clic en el botón "Implementar en Heroku".

   

2. Después de la implementación, configure Cursor:

   • Abrir Configuración del cursor → Características

   • Agregar nuevo servidor MCP

   • Utilice su URL de Heroku con la ruta /sse (por ejemplo, https://<your-app-name>.herokuapp.com/sse )

3. Pon a prueba el estado de ánimo de tu agente en Cursor:

   • Pregúntele a su agente: "Por favor, pregunte sobre el estado de ánimo de nuestro servidor y déjeme saber cómo está".

   • El servidor responderá con un mensaje alegre y un corazón ❤️

Related MCP server: MCP Server Template for Cursor IDE

Métodos de configuración alternativos

Puede ejecutar el servidor de tres maneras: usando Docker, la configuración tradicional de Python o directamente en Cursor IDE.

Configuración de Docker

El proyecto incluye soporte para Docker para una fácil implementación:

1. Configuración inicial:

# Clone the repository
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# Create environment file
cp .env.example .env

2. Construya y ejecute usando Docker Compose:

# Build and start the server
docker compose up --build -d

# View logs
docker compose logs -f

# Check server status
docker compose ps

# Stop the server
docker compose down

3. El servidor estará disponible en:

   • Punto final SSE: http://localhost:8000/sse

4. Prueba rápida:

# Test the server endpoint
curl -i http://localhost:8000/sse

5. Conectarse a Cursor IDE:

   • Abrir Configuración del cursor → Características

   • Agregar nuevo servidor MCP

   • Tipo: Seleccione "sse"

   • URL: Ingrese http://localhost:8000/sse

Configuración tradicional

Primero, instale el administrador de paquetes uv:

# Install uv on macOS
brew install uv
# Or install via pip (any OS)
pip install uv

Inicie el servidor utilizando stdio (predeterminado) o el transporte SSE:

# Install the package with development dependencies
uv pip install -e ".[dev]"

# Using stdio transport (default)
uv run mcp-simple-tool

# Using SSE transport on custom port
uv run mcp-simple-tool --transport sse --port 8000

# Run tests
uv run pytest -v

Después de la instalación, puede conectar el servidor directamente a Cursor IDE:

1. Haga clic derecho en el archivo cursor-run-mcp-server.sh en Cursor

2. Seleccione "Copiar ruta" para copiar la ruta absoluta

3. Abrir la configuración del cursor (icono de engranaje)

4. Vaya a la pestaña Características

5. Desplácese hacia abajo hasta "Servidores MCP"

6. Haga clic en "Agregar nuevo servidor MCP"

7. Rellene el formulario:

   • Nombre: Elija cualquier nombre (por ejemplo, "mi-servidor-mcp-1")

   • Tipo: Seleccione "stdio" (no "sse" porque ejecutamos el servidor localmente)

   • Comando: Pegue la ruta absoluta de cursor-run-mcp-server.sh que copió anteriormente. Por ejemplo: /Users/kirillmarkin/weaviate-mcp-server/cursor-run-mcp-server.sh

Variables de entorno

Variables de entorno disponibles (se pueden configurar en .env ):

• MCP_SERVER_PORT (predeterminado: 8000): puerto donde se ejecutará el servidor

• MCP_SERVER_HOST (predeterminado: 0.0.0.0): host al que vincular el servidor

• DEBUG (predeterminado: falso): habilita el modo de depuración

• MCP_USER_AGENT - Agente de usuario personalizado para la obtención de sitios web

Opciones adicionales

Instalación mediante herrería

Para instalar automáticamente la plantilla de servidor MCP para Cursor IDE para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude

Análisis del servidor Glama