{"type":"mcp_server","name":"example-mcp-server","description":"This repository provides a template for creating custom tools for Cursor IDE using the Model Context Protocol, allowing users to build and connect their own tools to the Cursor IDE environment.","category":"Developer Tools","language":"Python","stars":37,"forks":7,"owner":"kirill-markin","github_url":"https://github.com/kirill-markin/example-mcp-server","homepage":null,"setup":"## Setup\n\n**Quick Start:**\n\n1.  Click \"Deploy to Heroku\" button.\n2.  Configure Cursor: Open Cursor Settings → Features, add new MCP server, and use your Heroku URL with `/sse` path (e.g., `https://<your-app-name>.herokuapp.com/sse`).\n3.  Test your agent's mood in Cursor by asking it to inquire about the server mood.\n\n**Alternative Setup Methods:**\n\n**Docker Setup:**\n\n1.  Initial setup:\n    ```bash\n    # Clone the repository\n    git clone https://github.com/kirill-markin/weaviate-mcp-server.git\n    cd weaviate-mcp-server\n\n    # Create environment file\n    cp .env.example .env\n    ```\n2.  Build and run using Docker Compose:\n    ```bash\n    # Build and start the server\n    docker compose up --build -d\n\n    # View logs\n    docker compose logs -f\n\n    # Check server status\n    docker compose ps\n\n    # Stop the server\n    docker compose down\n    ```\n3.  The server will be available at: SSE endpoint: http://localhost:8000/sse\n4.  Quick test:\n    ```bash\n    # Test the server endpoint\n    curl -i http://localhost:8000/sse\n    ```\n5.  Connect to Cursor IDE: Open Cursor Settings → Features, add new MCP server, Type: Select \"sse\", URL: Enter `http://localhost:8000/sse`\n\n**Traditional Setup:**\n\n1.  Install the uv package manager:\n    ```bash\n    # Install uv on macOS\n    brew install uv\n    # Or install via pip (any OS)\n    pip install uv\n    ```\n2.  Start the server using either stdio (default) or SSE transport:\n    ```bash\n    # Install the package with development dependencies\n    uv pip install -e \".[dev]\"\n\n    # Using stdio transport (default)\n    uv run mcp-simple-tool\n\n    # Using SSE transport on custom port\n    uv run mcp-simple-tool --transport sse --port 8000\n\n    # Run tests\n    uv run pytest -v\n    ```\n3.  After installation, connect the server directly to Cursor IDE:\n    1.  Right-click on the `cursor-run-mcp-server.sh` file in Cursor\n    2.  Select \"Copy Path\" to copy the absolute path\n    3.  Open Cursor Settings (gear icon)\n    4.  Navigate to Features tab\n    5.  Scroll down to \"MCP Servers\"\n    6.  Click \"Add new MCP server\"\n    7.  Fill in the form: Name, Type (stdio), Command (path to `cursor-run-mcp-server.sh`)\n\n**Environment Variables:**\n\n*   `MCP_SERVER_PORT` (default: 8000) - Port to run the server on\n*   `MCP_SERVER_HOST` (default: 0.0.0.0) - Host to bind the server to\n*   `DEBUG` (default: false) - Enable debug mode\n*   `MCP_USER_AGENT` - Custom User-Agent for website fetching\n\n**Installing via Smithery:**\n\n```bash\nnpx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude\n```","tools":"## Available Tools\n\n1.  Custom tools for Cursor IDE (allows creating custom tools for Cursor IDE using Model Context Protocol (MCP))\n2.  Server mood response (responds with a cheerful message and a heart when asked about the server's mood).\n","faq":null,"created_at":"2025-02-04T12:02:40+00:00","updated_at":"2025-03-28T03:20:19+00:00","source_url":"https://model-context-protocol.com/servers/cursor-ide-custom-tools-mcp-server","related_articles":[]}