# MCP Simple

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

## Установка

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

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

#### Для публичного репозитория:
```bash
uvx mcp-simple
```

#### Для приватного репозитория:
```bash
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

Если вы предпочитаете локальную установку:
```bash
pip install -e .
```

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

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

2. Откройте файл `.env` и заполните необходимые значения:
   ```bash
   # Настройки сервера
   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).

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

```json
{
  "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

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

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

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

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

```bash
python main.py
```

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

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