MCP Server Template for Cursor IDE

Una plantilla sencilla para crear herramientas personalizadas para Cursor IDE mediante el Model Context Protocol (MCP). Crea tu propio repositorio a partir de esta plantilla, modifica las herramientas y conéctalas a tu Cursor IDE.

Inicio rápido

1. Haz clic en el botón «Desplegar en Heroku»

   

2. Después del despliegue, configura Cursor:

   • Abre Configuración de Cursor → Funciones

   • Añade un nuevo servidor MCP

   • Usa tu URL de Heroku con la ruta /sse (p. ej., https://<your-app-name>.herokuapp.com/sse)

3. Prueba el estado de ánimo de tu agente en Cursor:

   • Pregunta a tu agente «Por favor, pregunta por el estado de ánimo de nuestro servidor y dime cómo está.»

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

Related MCP server: pure.md MCP server

Métodos de configuración alternativos

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

Configuración con Docker

El proyecto incluye soporte para Docker para facilitar el despliegue:

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. Construye y ejecuta 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:

   • Endpoint SSE: http://localhost:8000/sse

4. Prueba rápida:

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

5. Conecta con Cursor IDE:

   • Abre Configuración de Cursor → Funciones

   • Añade un nuevo servidor MCP

   • Tipo: Selecciona «sse»

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

Configuración tradicional

Primero, instala el gestor de paquetes uv:

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

Inicia el servidor usando transporte stdio (por defecto) o 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, puedes conectar el servidor directamente a Cursor IDE:

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

2. Selecciona «Copiar ruta» para copiar la ruta absoluta

3. Abre Configuración de Cursor (icono de engranaje)

4. Ve a la pestaña Funciones

5. Desplázate hacia abajo hasta «Servidores MCP»

6. Haz clic en «Añadir nuevo servidor MCP»

7. Rellena el formulario:

   • Nombre: Elige cualquier nombre (p. ej., «my-mcp-server-1»)

   • Tipo: Selecciona «stdio» (no «sse» porque ejecutamos el servidor localmente)

   • Comando: Pega la ruta absoluta a cursor-run-mcp-server.sh que copiaste antes. Por ejemplo: /Users/yourname/weaviate-mcp-server/cursor-run-mcp-server.sh

Variables de entorno

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

• MCP_SERVER_PORT (por defecto: 8000) - Puerto en el que se ejecuta el servidor

• MCP_SERVER_HOST (por defecto: 0.0.0.0) - Host al que vincular el servidor

• DEBUG (por defecto: false) - Activa el modo de depuración

• MCP_USER_AGENT - User-Agent personalizado para la obtención de sitios web

Opciones adicionales

Instalación mediante Smithery

Para instalar MCP Server Template for Cursor IDE para Claude Desktop automáticamente mediante Smithery:

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

Reseña del servidor Glama