devprom-mcp
Officialby devprom-dev
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); этот адаптер распространяется свободно.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues