# @relbase/mcp

[![npm version](https://img.shields.io/npm/v/@relbase/mcp.svg)](https://www.npmjs.com/package/@relbase/mcp)
[![npm downloads](https://img.shields.io/npm/dm/@relbase/mcp.svg)](https://www.npmjs.com/package/@relbase/mcp)
[![license](https://img.shields.io/npm/l/@relbase/mcp.svg)](https://www.npmjs.com/package/@relbase/mcp)

MCP-сервер [RelBase](https://relbase.ru) для Cursor и других MCP-клиентов.

Пакет на npm: **[@relbase/mcp](https://www.npmjs.com/package/@relbase/mcp)**

Запускается локально через stdio и обращается к RelBase REST API с вашим PRO API-токеном.

## Установка

Отдельно ставить пакет не обязательно — Cursor подтянет его через `npx`:

```bash
npx -y @relbase/mcp
```

Или глобально:

```bash
npm install -g @relbase/mcp
```

Страница пакета: https://www.npmjs.com/package/@relbase/mcp

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

| Переменная | Описание |
|------------|----------|
| `RELBASE_API_URL` | Базовый URL API, по умолчанию `https://relbase.ru` |
| `RELBASE_API_TOKEN` | Токен из RelBase → **API и MCP** (обязательно) |

## Конфиг Cursor

`~/.cursor/mcp.json` или настройки MCP проекта:

```json
{
  "mcpServers": {
    "relbase": {
      "command": "npx",
      "args": ["-y", "@relbase/mcp"],
      "env": {
        "RELBASE_API_URL": "https://relbase.ru",
        "RELBASE_API_TOKEN": "1|rb_..."
      }
    }
  }
}
```

Токен создаётся в личном кабинете RelBase (тариф PRO).

## Tools

- `list_diagrams` — список диаграмм
- `get_diagram` — диаграмма по hash (включая DBML)
- `create_diagram` — создать диаграмму
- `update_diagram` — обновить диаграмму
- `delete_diagram` — удалить диаграмму
- `list_projects` — список проектов
- `list_groups` — список групп таблиц на холсте диаграммы
- `get_group` — группа по id
- `create_group` — создать группу
- `update_group` — обновить группу (частично)
- `delete_group` — удалить группу с холста

## Ссылки

- npm: https://www.npmjs.com/package/@relbase/mcp
- RelBase: https://relbase.ru
- Issues: https://github.com/evgeny-tc/relbase-mcp/issues

## Лицензия

MIT