mcpField
M
MCP Server Template for Cursor IDE

MCP Server Template for Cursor IDE

Local
github.com/chrisbodenDeveloper Tools5Updated 89w ago
Repository

About MCP Server Template for Cursor IDE

MCP Server Template for Cursor IDE is a starter for developers creating custom MCP servers and tools for Cursor IDE. It supports stdio or SSE connections and documents Docker, Python, and Heroku setup.

Key features

  1. 01Create custom MCP tools
  2. 02Support stdio and SSE transports
  3. 03Deploy with Docker
  4. 04Run locally with Python
  5. 05Follow Heroku deployment steps

Use cases

  1. 01Build custom tools for Cursor IDE
  2. 02Connect a deployed server over SSE
  3. 03Run a server locally over stdio
  4. 04Start the server with Docker Compose

MCP support

Servers created from the template can connect to Cursor IDE over stdio or SSE. The README also provides a Smithery install command for Claude Desktop.

#mcp#cursor-ide#server-template

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "mcp_template": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "compose"
      ]
    }
  }
}
Run commanddocker run -i --rm compose

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocicompose

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Server Template for Cursor IDE

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

Server Mood Response

Quick Start

  1. Click "Deploy to Heroku" button

    Deploy to Heroku

  2. After deployment, configure Cursor:

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

  3. Test your agent's mood in Cursor:

    • Ask your agent "Please ask about our server mood and let me know how it is."
    • The server will respond with a cheerful message and a heart ❤️

Alternative Setup Methods

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

Docker Setup

The 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 environment file
cp .env.example .env
  1. 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

  1. The server will be available at:

  2. Quick test:

# Test the server endpoint
curl -i http://localhost:8000/sse
  1. Connect to Cursor IDE:
    • Open Cursor Settings → Features
    • Add new MCP server
    • Type: Select "sse"
    • URL: Enter http://localhost:8000/sse
Traditional Setup

First, install the uv package manager:

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

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

# 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

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

  1. Right-click on the cursor-run-mcp-server.sh file in Cursor
  2. Select "Copy Path" to copy the absolute path
  3. Open Cursor Settings (gear icon)
  4. Navigate to Features tab
  5. Scroll down to "MCP Servers"
  6. Click "Add new MCP server"
  7. Fill in the form:
    • Name: Choose any name (e.g., "my-mcp-server-1")
    • Type: Select "stdio" (not "sse" because we run the server locally)
    • Command: Paste the absolute path to cursor-run-mcp-server.sh that you copied earlier. For example: /Users/kirillmarkin/weaviate-mcp-server/cursor-run-mcp-server.sh
Environment Variables

Available environment variables (can be set in .env):

  • MCP_SERVER_PORT (default: 8000) - Port to run the server on
  • MCP_SERVER_HOST (default: 0.0.0.0) - Host to bind the server to
  • DEBUG (default: false) - Enable debug mode
  • MCP_USER_AGENT - Custom User-Agent for website fetching

Additional options

Installing via Smithery

smithery badge

To install MCP Server Template for Cursor IDE for Claude Desktop automatically via Smithery:

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

Server Template for Cursor IDE MCP server

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.