openemis-mcp

Бесплатный, только для чтения MCP-мост между AI-агентами и любым экземпляром OpenEMIS.

Построен на основе опубликованного OpenEMIS Core API (справочник: api.openemis.org/core) и проверен на публичном демо-сайте demo.openemis.org/core.

Задавайте вопросы простым языком:

"Сколько учеников сейчас учится в начальной школе Эвори?"

Агент планирует вызовы, этот MCP предоставляет данные:

"В начальной школе Эвори в настоящее время зачислено 97 учеников в 6 классах."

Никакого кода. Никакого JSON. Просто спросите.

Что включено (бесплатно, MIT)

| Инструмент | Что делает | |---|---| | openemis_health | Проверить доступность настроенного экземпляра — реальный цикл входа в систему | | openemis_list_domains | Список 9 курируемых доменов (Посещаемость, Оценивание, Персонал, Ученики…) | | openemis_discover | Тема → до 30 ограниченных эндпоинтов. Поддерживает диалоги компактными | | openemis_list_playbooks | Список всех 24 курируемых руководств по рабочим процессам | | openemis_get_playbook | Загрузить руководство по id — полные шаги, ресурсы, важные примечания | | openemis_get | Унифицированное чтение: список или отдельная запись, любой ресурс, любые фильтры |

24 курируемых руководства по рабочим процессам, охватывающие посещаемость, оценивание, профили учеников, профили сотрудников, инфраструктуру, питание, панели управления рисками, отчеты по классам, расписания и многое другое — каждое проверено на соответствие манифесту v5 при 100% покрытии ресурсов.

Доступны переводы: Русский · Испанский · Хинди · Арабский — все 24 руководства на всех четырёх языках.

✏️ Операции записи (создание/обновление записей в OpenEMIS) требуют openemis-mcp-pro. Этот бесплатный сервер намеренно работает только в режиме чтения — post, put и delete недоступны.

Что входит в Pro

openemis-mcp-pro добавляет инструменты записи, удалённый хостинг и совместимость с ChatGPT поверх этого бесплатного сервера только для чтения.

| | Бесплатно | Индивидуальный Pro | Учрежденческий Pro | Страновой Pro | |---|---|---|---|---| | Инструменты чтения (все 645 ресурсов) | ✅ | ✅ | ✅ | ✅ | | 24 руководства для чтения × 5 языков | ✅ | ✅ | ✅ | ✅ | | 3 руководства для записи (v0.2+) | — | ✅ | ✅ | ✅ | | Режим stdio (Claude Code, Cursor, Cline) | ✅ | ✅ | ✅ | ✅ | | Режим HTTP-сервера (Oracle / VPS — установить один раз, подключаться по URL) | — | ✅ | ✅ | ✅ | | Адаптер OpenAPI (ChatGPT Custom GPT, любой REST-клиент) | — | ✅ | ✅ | ✅ | | Прямая запись — одна запись | — | ✅ | ✅ | ✅ | | Аудит действий по учреждению | — | — | ✅ | ✅ | | Выполнение маршрута рабочего процесса | — | — | ✅ | ✅ | | Шлюз утверждения администратором учреждения | — | — | ✅ | ✅ | | Пакетные операции в рамках одного учреждения | — | — | ✅ | ✅ | | Пакетные операции для нескольких учреждений | — | — | — | ✅ | | Шлюзы утверждения министерством | — | — | — | ✅ | | Межучрежденческий контроль | — | — | — | ✅ |

Режим HTTP-сервера позволяет установить Pro один раз на экземпляре Oracle Always Free ARM и подключаться с любого устройства — без настройки на каждой машине. Встроенный адаптер OpenAPI означает, что учителя могут использовать ChatGPT (или любого AI-ассистента) для отметки посещаемости и поиска записей учеников, импортируя единственный URL схемы. См. Руководство для учителя по ChatGPT для пошаговой настройки.

→ Цены: [email protected]

Установка

Требуется Node 22+.

git clone https://github.com/tixuz/openemis-mcp.git
cd openemis-mcp
npm install
npm run build
cp .env.example .env
$EDITOR .env

Настройка

OPENEMIS_BASE_URL=https://demo.openemis.org/core
OPENEMIS_USERNAME=admin
OPENEMIS_PASSWORD=your_password
OPENEMIS_API_KEY=your_api_key

Тест работоспособности

set -a && source .env && set +a
node scripts/smoke-login.mjs

Регистрация в Claude Code

claude mcp add openemis \
  --env OPENEMIS_BASE_URL="https://your-instance/core" \
  --env OPENEMIS_USERNAME="…" \
  --env OPENEMIS_PASSWORD="…" \
  --env OPENEMIS_API_KEY="…" \
  -- node "$(pwd)/dist/server.js"

Работает с любым MCP-совместимым клиентом: Claude Code, Cursor, Cline, Codex (через gemmy-and-qwenny) или любым stdio MCP-клиентом.

🌐 Удалённая / серверная установка: openemis-mcp-pro добавляет режим HTTP-сервера — установите один раз на Oracle Always Free, и каждый AI-ассистент (Claude Code, Cursor, ChatGPT) будет подключаться по URL без настройки на каждой машине. См. Руководство для учителя по ChatGPT, чтобы узнать, как позволить учителям отмечать посещаемость через ChatGPT.

Руководства по рабочим процессам

24 курируемых руководства — см. docs/playbooks/:

| # | Руководство | Домен | Переводы | |---|---|---|---| | 1 | Подсчёт вакантных должностей | Персонал | RU · ES · HI · AR | | 2 | Отметить посещаемость ученика | Посещаемость | RU · ES · HI · AR | | 3 | Отметить посещаемость сотрудника | Персонал | RU · ES · HI · AR | | 4 | Просмотреть расписание ученика | Расписание | RU · ES · HI · AR | | 5 | Панель управления ученика | Ученики | RU · ES · HI · AR | | 6 | Создать PDF-отчёт об успеваемости ученика | Отчёт | RU · ES · HI · AR | | 7 | Зачислить нового ученика | Ученики | RU · ES · HI · AR | | 8 | Записать инцидент с поведением | Ученики | RU · ES · HI · AR | | 9 | Внести оценки за экзамен | Оценивание | RU · ES · HI · AR | | 10 | Сводка по учреждению | Учреждение | RU · ES · HI · AR | | 11 | Создать PDF со статистикой учреждения | Отчёт | RU · ES · HI · AR | | 12 | Просмотреть последнюю посещаемость | Посещаемость | RU · ES · HI · AR | | 13 | Просмотреть профиль ученика | Ученики | RU · ES · HI · AR | | 14 | Просмотреть оценки ученика | Оценивание | RU · ES · HI · AR | | 15 | Просмотреть отчёт по классу | Отчёт | RU · ES · HI · AR | | 16 | Просмотреть расписание | Расписание | RU · ES · HI · AR | | 17 | Просмотреть полный профиль учреждения | Учреждение | RU · ES · HI · AR | | 18 | Просмотреть полный профиль класса | Ученики | RU · ES · HI · AR | | 19 | Просмотреть полный профиль сотрудника | Персонал | RU · ES · HI · AR | | 20 | Расширить профиль ученика | Ученики | RU · ES · HI · AR | | 21 | Просмотреть инфраструктуру учреждения | Учреждение | RU · ES · HI · AR | | 22 | Просмотреть питание в учреждении | Учреждение | RU · ES · HI · AR | | 23 | Просмотреть профиль рисков ученика и случаи социальной помощи | Ученики | RU · ES · HI · AR | | 24 | Просмотреть сводку по рискам учреждения и правила оповещений | Учреждение | RU · ES · HI · AR |

Архитектура

Агент (Claude / Cursor / Codex / …)
        │ MCP stdio
openemis-mcp  ←  6 инструментов чтения + 24 руководства
        │ HTTPS + Bearer JWT
OpenEMIS Core API  /api/v5/{ресурс}

Обнаружение, ограниченное доменом, поддерживает диалоги компактными — openemis_discover("attendance") возвращает 20–30 эндпоинтов, относящихся к посещаемости, а не все 1350.

🖥️ Режим сервера / HTTP (установить один раз на Oracle, подключаться откуда угодно, включая ChatGPT) доступен в openemis-mcp-pro.

Документация

• Справочник по ресурсам — все 645 ресурсов с доступными методами
• Руководства по рабочим процессам — 24 руководства на английском, русском, испанском, хинди и арабском
• ACKNOWLEDGEMENTS.md — команда AI, которая это создала

Лицензия

MIT © 2026 Khindol Madraimov

Не аффилирован с OpenEMIS или его разработчиками. Сторонний мост к публичному Core API. Учётные данные остаются на вашем компьютере.