MCP Server Template For Cursor Ide Ma0

🚀 Cursor IDE MCP Server Template

A simple template for creating custom tools for the Cursor IDE using the Model Context Protocol (MCP). Create your own repository from this template, modify the tool, and connect it to your Cursor IDE.

🚀 Quick Start

1. Click the "Deploy to Heroku" button:

   

2. After deployment, configure in Cursor:

   • Open "Cursor Settings" → "Features".
   • Add a new MCP server.
   • Use your Heroku URL and the /sse path (e.g., https://<your-app-name>.herokuapp.com/sse).

3. Test the agent's mood in Cursor:

   • Ask your agent: "Please tell me the mood of our server."
   • The server will reply with a cheerful message and a ❤️.

✨ Alternative Setup Methods

You can run the server in three ways: using Docker, traditional Python installation, or directly in the Cursor IDE.

📦 Docker Setup

This project includes Docker support for easy deployment:

1. Initial setup:

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

# Create the environment file
cp .env.example .env

2. Build and run using 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. The server will be available at the following address:

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

4. Quick test:

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

5. Connect to the Cursor IDE:
   • Open "Cursor Settings" → "Features".
   • Add a new MCP server.
   • Type: Select "sse".
   • URL: Enter http://localhost:8000/sse.

📦 Traditional Installation

First, install the uv package manager:

# Install uv on macOS
brew install uv
# Or install using pip on any operating system
pip install uv

Start the server using stdio (default) or SSE transport:

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

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

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

# Run tests
uv run pytest -v

After installation, you can directly connect the server to the Cursor IDE:

1. Right-click on the following:
   • Open "Cursor Settings" → "Features".
   • Add a new MCP server.
   • Type: Select "stdio".
   • Binary file path: Enter $(which uv).

🔧 Environment Variables

The following are the environment variables you can use:

📚 Additional Options

Installation via Smithery

You can install via Smithery using the following command:

smithery install mcp-server-template

Glama Server Review