MCP Server Template for Cursor IDE

Простой шаблон для создания пользовательских инструментов для Cursor IDE с использованием Model Context Protocol (MCP). Создайте свой репозиторий из этого шаблона, измените инструменты и подключите их к вашей Cursor IDE.

Быстрый старт

1. Нажмите кнопку «Deploy to Heroku»

   

2. После развертывания настройте Cursor:

   • Откройте Настройки Cursor → Функции

   • Добавьте новый MCP-сервер

   • Используйте ваш URL Heroku с путём /sse (например, https://<your-app-name>.herokuapp.com/sse)

3. Проверьте настроение вашего агента в Cursor:

   • Спросите вашего агента: «Пожалуйста, спросите о настроении нашего сервера и сообщите мне, как оно».

   • Сервер ответит весёлым сообщением и сердечком ❤️

Related MCP server: pure.md MCP server

Альтернативные способы настройки

Вы можете запустить сервер тремя способами: с помощью Docker, традиционной настройки Python или непосредственно в Cursor IDE.

Настройка Docker

Проект включает поддержку Docker для простого развертывания:

1. Первоначальная настройка:

# 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

2. Соберите и запустите с помощью 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

3. Сервер будет доступен по адресу:

   • SSE-адрес: http://localhost:8000/sse

4. Быстрая проверка:

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

5. Подключение к Cursor IDE:

   • Откройте Настройки Cursor → Функции

   • Добавьте новый MCP-сервер

   • Тип: Выберите «sse»

   • URL: Введите http://localhost:8000/sse

Традиционная настройка

Сначала установите менеджер пакетов uv:

# Install uv on macOS
brew install uv
# Or install via pip (any OS)
pip install uv

Запустите сервер, используя либо stdio (по умолчанию), либо SSE-транспорт:

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

# Using stdio transport (default)
uv run mcp-simple-tool

# Using SSE transport on custom port
uv run mcp-simple-tool --transport sse --port 8000

# Run tests
uv run pytest -v

После установки вы можете подключить сервер напрямую к Cursor IDE:

1. Щёлкните правой кнопкой мыши по файлу cursor-run-mcp-server.sh в Cursor

2. Выберите «Copy Path», чтобы скопировать абсолютный путь

3. Откройте Настройки Cursor (значок шестерёнки)

4. Перейдите на вкладку «Функции»

5. Прокрутите вниз до «MCP Servers»

6. Нажмите «Добавить новый MCP-сервер»

7. Заполните форму:

   • Имя: Выберите любое имя (например, «my-mcp-server-1»)

   • Тип: Выберите «stdio» (не «sse», так как мы запускаем сервер локально)

   • Команда: Вставьте абсолютный путь к cursor-run-mcp-server.sh, который вы скопировали ранее. Например: /Users/yourname/weaviate-mcp-server/cursor-run-mcp-server.sh

Переменные окружения

Доступные переменные окружения (можно задать в .env):

• MCP_SERVER_PORT (по умолчанию: 8000) — порт для запуска сервера

• MCP_SERVER_HOST (по умолчанию: 0.0.0.0) — хост для привязки сервера

• DEBUG (по умолчанию: false) — включить режим отладки

• MCP_USER_AGENT — пользовательский User-Agent для получения веб-сайтов

Дополнительные параметры

Установка через Smithery

Чтобы установить MCP Server Template for Cursor IDE для Claude Desktop автоматически через Smithery:

npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude

Обзор сервера Glama