MCP Simple

Простой MCP сервер на Python.

Установка

Через uvx (рекомендуется)

Для установки и запуска сервера используйте uvx. Это позволит запускать сервер без глобальной установки пакета.

Для публичного репозитория:

uvx mcp-simple

Для приватного репозитория:

uvx --from git+https://oauth2:YOUR_GITHUB_TOKEN@github.com/YOUR_USERNAME/mcp-simple.git mcp-simple

Замените YOUR_GITHUB_TOKEN на ваш GitHub Personal Access Token с правами на чтение репозитория, и YOUR_USERNAME на ваше имя пользователя GitHub.

Альтернативная установка через pip

Если вы предпочитаете локальную установку:

pip install -e .

Настройка переменных окружения

1. Скопируйте файл .env.example в .env:

   cp .env.example .env
   

2. Откройте файл .env и заполните необходимые значения:

   # Настройки сервера
   SERVER_HOST=localhost
   SERVER_PORT=8000
   
   # База данных
   DATABASE_URL=sqlite:///mcp_simple.db
   
   # API ключи (если нужны)
   # API_KEY=your_api_key_here
   

   • SERVER_HOST: Хост, на котором будет запущен сервер (по умолчанию localhost)
   • SERVER_PORT: Порт сервера (по умолчанию 8000)
   • DATABASE_URL: URL базы данных (по умолчанию SQLite)
   • API_KEY: Ваш API ключ, если требуется для внешних сервисов

Конфигурация для Claude Desktop

Для использования MCP сервера в Claude Desktop, добавьте следующую конфигурацию в файл claude_desktop_config.json (обычно находится в ~/Library/Application Support/Claude/ на macOS или %APPDATA%\Claude\ на Windows).

Пример конфигурации для приватного репозитория:

{
  "mcpServers": {
    "mcp-simple": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://oauth2:YOUR_GITHUB_TOKEN@github.com/YOUR_USERNAME/mcp-simple.git",
        "mcp-simple"
      ],
      "env": {
        "SERVER_HOST": "localhost",
        "SERVER_PORT": "8000",
        "DATABASE_URL": "sqlite:///mcp_simple.db"
      }
    }
  }
}

Важные замечания:

• Убедитесь, что у вашего GitHub токена есть права на чтение приватного репозитория
• Переменные окружения можно переопределить в секции env конфигурации
• После изменения конфигурации перезапустите Claude Desktop
• Сервер будет автоматически запускаться при старте Claude Desktop

Использование

После настройки запустите сервер:

uvx --from git+https://oauth2:YOUR_GITHUB_TOKEN@github.com/YOUR_USERNAME/mcp-simple.git mcp-simple

Или, если установлено локально:

python main.py

Структура проекта

• src/mcp_server/ - исходный код сервера
• tests/ - тесты
• pyproject.toml - конфигурация проекта
• .env.example - пример файла переменных окружения