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 .

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

Скопируйте файл .env.example в .env:
```
cp .env.example .env
```
Откройте файл .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 - пример файла переменных окружения

mcp-simple