Uncert manager MCP (uncert-mcp)

stdio MCP-сервер: tools к HTTP API Uncert с personal access token. Хост (Cursor, Claude Desktop и др.) запускает процесс и ходит в API как PAT-пользователь.

После публикации на PyPI хост ставит пакет сам через uvx — клонировать репозиторий не нужно.

Выпустить PAT

1. Войдите в Uncert.
2. Откройте Настройки — /me/settings.
3. Создайте personal access token и скопируйте сырое значение uncert_pat_….

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

Пустые значения — процесс не стартует и пишет имя переменной в stderr.

Cursor / любой MCP-хост (из PyPI)

Нужны uv и PAT. В конфиге хоста (~/.cursor/mcp.json или Settings → MCP):

{
  "mcpServers": {
    "uncert": {
      "command": "uvx",
      "args": ["uncert-mcp"],
      "env": {
        "UNCERT_API_URL": "https://uncert.ru/api",
        "UNCERT_PAT": "YOUR_PAT_HERE"
      }
    }
  }
}

На macOS, если GUI не видит uvx в PATH, подставьте абсолютный путь (часто /opt/homebrew/bin/uvx или ~/.local/bin/uvx).

Токен только в пользовательском конфиге, не в git.

Разработка из репозитория

cd apps/mcp
export UNCERT_API_URL=http://localhost:8001/api
export UNCERT_PAT=uncert_pat_…
uv run uncert-mcp

Локальный пример хоста — mcp.json.example.

Публикация на PyPI

Релиз: поднять version в pyproject.toml, тег mcp-v0.1.0 (совпадает с версией) или Actions → Publish MCP to PyPI → Run workflow.

Нужен Trusted Publisher на PyPI (проект uncert-mcp, репо prakt1ka/uncert, workflow publish-mcp.yml, environment pypi).