example

This MCP server template exposes a simple consumer for Cursor IDE that uses the Model Context Protocol (MCP). After deployment or local setup, the server provides an SSE endpoint at /sse that Cursor can subscribe to for tool responses, including sentiment/mood prompts and related interactions. The server is designed to be extended with a collection of tools; at minimum, it supports a mood-testing workflow where sending a prompt like 'Please ask about our server mood and let me know how it is.' yields a cheerful response. To connect, configure Cursor by adding a new MCP server and point it to the server URL with the /sse path. The template supports multiple setup methods (Docker, traditional Python/uv, or running directly in Cursor IDE).

Prerequisites:

• Docker (optional, for Docker-based setup)
• Python and uv (for uv-based setup) or Node.js if you choose a Node-based path
• curl or similar tool for health/tests

Install options:

Docker setup:

# Clone the repository
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# Create environment file if needed
cp .env.example .env

# Build and run using Docker Compose
docker compose up --build -d

# View logs
docker compose logs -f

# Check status
docker compose ps

# Stop the server
docker compose down

Traditional Python/uv setup (uvx):

# Install uv (if not already installed)
brew install uv  # macOS
# Or install via pip
pip install uv

# Install the package in editable/dev mode (example)
uv pip install -e ".[dev]"

# Run the MCP server (stdio by default)
uv run mcp-simple-tool

# Or run with SSE transport and a custom port
uv run mcp-simple-tool --transport sse --port 8000

# Run tests
uv run pytest -v

Cursor IDE integration steps (manual):

1. Open Cursor Settings → Features
2. Add new MCP server
3. Type: stdio (or choose SSE if you are running SSE)
4. Command: Provide the path to the server executable or the URL with /sse as applicable

Note: If you use the Docker route, ensure the server exposes port 8000 (default) or set MCP_SERVER_PORT accordingly. The example configuration in the repository uses the uv/stdio approach with an mcp-simple-tool entry point.

Environment variables to consider (can be set in .env):

• MCP_SERVER_PORT (default: 8000)
• MCP_SERVER_HOST (default: 0.0.0.0)
• DEBUG (default: false)
• MCP_USER_AGENT (optional, for customizing HTTP requests) Common issues: ensure the /sse endpoint is reachable from Cursor (network/firewall rules). If using Docker, map the container port to your host and update the Cursor server URL accordingly. When using uv, ensure the correct tool name (mcp-simple-tool) matches the package entry point. If you encounter transport errors, verify whether you’re using stdio or SSE as configured in Cursor and the command-line arguments passed to uv.