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- пример файла переменных окружения
