MCP Template

🚀 MCP Server Template for Cursor IDE

A simple template for creating custom tools in 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 Cursor:

   • Open Cursor Settings → Features.
   • Add a new MCP server.
   • Use your Heroku URL with 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 our server's mood."
   • The server will respond with a cheerful message and a ❤️.

📦 Installation

You can run the server in three ways: using Docker, traditional Python setup, or directly in 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 the 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 Cursor IDE:
   • Open Cursor Settings → Features.
   • Add a 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 using pip on any operating system
pip install uv

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

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

# Use stdio transport
uv run main:app

# Use SSE transport
uv run --sse main:app

Environment Variables

Add the following to the .env file:

MCP_SERVER_PORT=5000
MCP_SERVER_NAME=example-server

📚 Documentation

• Complete documentation and examples can be found here.
• If you have any questions, please submit them on GitHub Issues.