gti-1c-mcp

MCP-сервер (Model Context Protocol) для 1С:БИТ / БИТ.СТРОИТЕЛЬСТВО.

Три независимых блока:

• База знаний инструкций — полнотекстовый поиск и выдача 73 инструкций пользователя 1С.БИТ

• Профили доступа RBAC — keyword-подбор профиля группы доступа, матрица ролей, валидация, уровень согласования

• Маппинг должность → профили — типовые профили доступа по должности на основе реальных обезличенных данных (417 должностей)

Не содержит LLM-зависимостей и логики провижининга заявок — это отдельный сервис.

Репозитории

Related MCP server: INFATON MCP35

Инструменты (12)

База знаний

Профили доступа

Маппинг должность → профили (обезличенные данные)

Установка на новом рабочем месте

Требования

• Node.js 18+ (скачать)

• Git

• (опционально) Docker + Docker Compose

Вариант 1 — локальный запуск (Node.js)

Шаг 1. Клонировать репозиторий

# С GitHub:
git clone https://github.com/RomanSaranindev/gti-1c-mcp.git

# Или с GitLab (внутренний):
git clone https://gitlab.ide-spb.com/saraninrg/gti-1c-mcp.git

cd gti-1c-mcp

Шаг 2. Установить зависимости

npm install

Шаг 3. Настроить окружение

# Скопировать шаблон
cp .env.example .env

Открыть .env и задать токен:

MCP_PORT=3031
MCP_API_TOKEN=ВАШ_СЕКРЕТНЫЙ_ТОКЕН

Токен по умолчанию gti-mcp-token-2024 — обязательно смените перед деплоем.

Шаг 4. Запустить сервер

npm start

Проверить:

curl http://localhost:3031/health

Вариант 2 — Docker

git clone https://github.com/RomanSaranindev/gti-1c-mcp.git
cd gti-1c-mcp

cp .env.example .env
# Отредактировать .env — задать MCP_API_TOKEN

docker-compose up -d

Проверить:

curl http://localhost:3031/health

Вариант 3 — автозапуск на Windows (Task Scheduler)

Чтобы сервер стартовал при загрузке Windows без ручного запуска:

1. Открыть Планировщик заданий (taskschd.msc)

2. Действие → Создать задачу

3. Вкладка Общие: имя gti-1c-mcp, выполнять для всех пользователей

4. Вкладка Триггеры: При запуске системы

5. Вкладка Действия → Создать:

   • Программа: node

   • Аргументы: src/server.js

   • Рабочая папка: полный путь к папке проекта (например C:\projects\gti-1c-mcp)

6. Вкладка Условия: снять галку "Только при питании от сети"

7. ОК → ввести пароль пользователя Windows

Или через PowerShell (запустить от администратора):

$action = New-ScheduledTaskAction `
    -Execute "node" `
    -Argument "src/server.js" `
    -WorkingDirectory "C:\projects\gti-1c-mcp"

$trigger = New-ScheduledTaskTrigger -AtStartup

Register-ScheduledTask `
    -TaskName "gti-1c-mcp" `
    -Action $action `
    -Trigger $trigger `
    -RunLevel Highest `
    -Force

Подключение к MCP-клиенту

OpenCode / Kilo Code

Добавить в ~/.config/opencode/opencode.json:

{
  "mcp": {
    "gti-1c": {
      "type": "remote",
      "url": "http://localhost:3031/mcp",
      "headers": { "X-MCP-Token": "ВАШ_ТОКЕН" },
      "enabled": true
    }
  }
}

После сохранения — перезапустить opencode.

Claude Desktop

В файл конфигурации Claude Desktop:

{
  "mcpServers": {
    "gti-1c": {
      "url": "http://localhost:3031/mcp",
      "headers": { "X-MCP-Token": "ВАШ_ТОКЕН" }
    }
  }
}

Если сервер на другой машине в сети

Замените localhost на IP или hostname сервера:

{
  "mcp": {
    "gti-1c": {
      "type": "remote",
      "url": "http://192.168.1.100:3031/mcp",
      "headers": { "X-MCP-Token": "ВАШ_ТОКЕН" },
      "enabled": true
    }
  }
}

Убедитесь, что порт 3031 открыт в брандмауэре сервера:

# На сервере (PowerShell, от администратора):
New-NetFirewallRule -DisplayName "gti-1c-mcp" -Direction Inbound -Protocol TCP -LocalPort 3031 -Action Allow

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

Структура

gti-1c-mcp/
├── src/
│   ├── server.js           # HTTP + MCP (12 инструментов)
│   ├── knowledge_base.js   # загрузка/поиск/выдача инструкций + fs.watch автоперезагрузка
│   ├── rbac_matrix.js      # матрица RBAC и профили доступа (122 профиля)
│   ├── job_profiles.js     # маппинг должность → профили (417 должностей, обезличенные данные)
│   └── vector_search.js    # TF-IDF + cosine similarity семантический поиск (офлайн)
├── knowledge/
│   └── instructions/       # 73 инструкции пользователя 1С.БИТ (.md)
├── .env.example
├── Dockerfile
├── docker-compose.yml
└── package.json

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

• Смените MCP_API_TOKEN перед публичным деплоем.

• Эндпоинты /health и / доступны без токена, все остальные — нет.

• Не публикуйте .env файл в репозиторий (он добавлен в .gitignore).