MCP Server Template For Cursor IDE

🚀 Simple Example of Creating Custom Tools with Cursor IDE MCP Server Template

This is a simple template for creating custom tools for the Cursor IDE using the Model Context Protocol (MCP). You can create your own repository from this template, modify the tools, and connect them to your Cursor IDE.

🚀 Quick Start

1. Click the "Deploy to Heroku" button:

   

2. After the deployment is complete, configure 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 mood of the proxy in Cursor:

   • Ask your proxy "Please tell me the mood of our server."
   • The server will respond with a pleasant message and a heart ❤️.

📦 Alternative Setup Methods

You can run the server in three ways: using Docker, traditional Python setup, or directly in the 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 an 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 accessible 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 the server to the 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 use pip (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 in the 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. Go to the "Features" tab.
5. Scroll to the bottom to "MCP Servers".
6. Click "Add New MCP Agent".
7. Paste the copied path in the "Executable" field.

📄 Other Information

• Environment Variables: In the config.json file, you can specify the following environment variables:

  • PORT: Set the server port, default is 80.
  • API_KEY: Set the key for authentication.
  • DEBUG: Enable debug mode (true or false).

• Quick Start Example:

# Download and run the container
docker run -it --rm -p 8000:8000 -e PORT=8000 -e API_KEY=your_key here/wego

# Access the control panel
Open your browser and visit http://localhost:8000/admin

⚠️ Important Note

Make sure to protect your API key in a production environment and update your password regularly to ensure security.

📚 Additional Information

Install the Server Template with Smithereen

You can install the server template via Smithereen using the following command:

smithereen install --template mcp-server-template

Glama Server Review