MCP Server Template for Cursor IDE

What is MCP Server Template for Cursor IDE?

A template for creating custom tools for Cursor IDE using Model Context Protocol (MCP). It allows developers to deploy a simple MCP server that responds with a cheerful message and can be extended with custom tools.

How to use MCP Server Template for Cursor IDE?

Deploy via Heroku button or run locally with Docker, traditional Python setup, or directly in Cursor IDE. Configure Cursor Settings → Features → Add new MCP server using SSE URL (Heroku or local) or stdio via the provided shell script.

Key features of MCP Server Template for Cursor IDE

• Deployable to Heroku with one click
• Supports Docker Compose for local development
• Traditional Python setup with uv package manager
• Runs via SSE or stdio transport
• Includes a sample mood-checking tool
• Pre‑configured Cursor IDE integration script

Use cases of MCP Server Template for Cursor IDE

• Quickly add a custom MCP tool to Cursor IDE
• Test MCP server functionality with a simple mood response
• Use as a starting point for building more complex MCP servers
• Deploy a publicly accessible MCP server on Heroku

FAQ from MCP Server Template for Cursor IDE

What transports are supported?

The server supports SSE (Server‑Sent Events) and stdio transport. Stdio is the default, SSE can be enabled with the --transport sse flag.

How do I connect the server to Cursor IDE?

For SSE: Add a new MCP server in Cursor Settings → Features, select type “sse”, and enter the URL (e.g., http://localhost:8000/sse). For stdio: add a new MCP server, select type “stdio”, and provide the absolute path to cursor-run-mcp-server.sh.

What are the environment variables?

MCP_SERVER_PORT (default 8000), MCP_SERVER_HOST (default 0.0.0.0), DEBUG (default false), and MCP_USER_AGENT for custom web fetching.

What are the runtime requirements?

Python and the uv package manager, or Docker. The project depends on the MCP framework and other packages listed in pyproject.toml.