Skip to main content
Glama
README.md
# devprom-mcp

[Devprom ALM](https://devprom.ru) — российская платформа управления жизненным циклом разработки ПО (требования, трассировка, тест-менеджмент), on-premise, реестр российского ПО №1188. Этот пакет подключает ИИ-агентов (Claude, Cursor и др.) к вашему экземпляру Devprom через Model Context Protocol.

**English:** `devprom-mcp` is a stdio MCP adapter for the built-in MCP server of [Devprom ALM](https://devprom.ru) — the Russian on-premise application lifecycle management platform (requirements management, traceability, test management). It proxies every MCP request to your own Devprom instance, so the agent sees all of its tools.

## Как это работает

Devprom ALM поставляется со встроенным MCP-сервером (разворачивается вместе с ПО; эндпоинт `https://<server-name>/mcp`; см. [документацию](https://docs.myalm.ru)). Многие клиенты MCP — например, Claude Desktop — удобнее всего работают с локальными stdio-серверами. `devprom-mcp` решает это: он запускается локально как stdio-сервер и прозрачно проксирует все вызовы на ваш Devprom. Агент автоматически видит инструменты вашего сервера: семантический поиск требований, запросы на языке DQL, создание комментариев, работу с пожеланиями/задачами/требованиями и т.д.

## Установка и настройка

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

| Переменная | Обязательна | Описание |
|---|---|---|
| `DEVPROM_BASE_URL` | да* | Базовый URL вашего Devprom, например `https://alm.company.ru` |
| `DEVPROM_AUTH_KEY` | да | Ключ авторизации пользователя MCP (см. ниже про безопасность) |
| `DEVPROM_MCP_URL` | нет | Полный URL MCP-эндпоинта, если отличается от `<base>/mcp` |
| `DEVPROM_TIMEOUT` | нет | Таймаут запросов, сек (по умолчанию 60) |

\* либо задайте `DEVPROM_MCP_URL` напрямую.

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "devprom": {
      "command": "uvx",
      "args": ["devprom-mcp"],
      "env": {
        "DEVPROM_BASE_URL": "https://alm.company.ru",
        "DEVPROM_AUTH_KEY": "ваш-ключ"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add devprom -- uvx devprom-mcp \
  -e DEVPROM_BASE_URL=https://alm.company.ru \
  -e DEVPROM_AUTH_KEY=ваш-ключ
```

### Cursor / любой stdio-клиент (`.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "devprom": {
      "command": "uvx",
      "args": ["devprom-mcp"],
      "env": {
        "DEVPROM_BASE_URL": "https://alm.company.ru",
        "DEVPROM_AUTH_KEY": "ваш-ключ"
      }
    }
  }
}
```

### Без адаптера (клиенты с поддержкой удалённых HTTP-серверов)

Claude Code, Cursor и другие современные клиенты могут подключаться напрямую:

```json
{
  "mcpServers": {
    "devprom": {
      "url": "https://alm.company.ru/mcp",
      "headers": {
        "Devprom-Auth-Key": "ваш-ключ",
        "Devprom-Base-Url": "https://alm.company.ru/"
      }
    }
  }
}
```

## Безопасность

Рекомендация Devprom: заведите в ALM **отдельную учётную запись для MCP** и настройте её права — какие проекты доступны агенту и какие операции разрешены (чтение, запись, удаление, доступ к отдельным сущностям). Ключ передаётся только через переменные окружения.

## Требования

- Python 3.10+
- Развёрнутый экземпляр Devprom ALM со встроенным MCP-сервером (доступен `https://<server-name>/mcp`)
- [uv](https://docs.astral.sh/uv/) (для `uvx`) или `pip install devprom-mcp`

## Разработка

```bash
git clone https://github.com/devprom-dev/devprom-mcp
cd devprom-mcp
uv sync && uv run devprom-mcp
```

## Лицензия

MIT. Devprom ALM — коммерческий продукт ООО «Девпром» (devprom.ru); этот адаптер распространяется свободно.