ExampleSAFE

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.

Quick Start

1. Click "Deploy to Heroku" button

[](https://heroku.com/deploy?template=https://github.com/kirill-markin/weaviate-mcp-server)

1. After deployment, configure Cursor:
2. Open Cursor Settings → Features
3. Add new MCP server
4. Use your Heroku URL with /sse path (e.g., https://.herokuapp.com/sse)

1. Test your agent's mood in Cursor:
2. Ask your agent "Please ask about our server mood and let me know how it is."
3. 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. SSE endpoint: http://localhost:8000/sse

1. Quick test:

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

1. Connect to Cursor IDE:
2. Open Cursor Settings → Features
3. Add new MCP server
4. Type: Select "sse"
5. 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