Kanysh Basic · MCP-копилот · локально

Kanysh Basic.
Расчёты
по модели —
из чата.

AI-копилот для расчётов по геологическим моделям рядом с Petrel и RMS. Откройте выгруженную модель, посчитайте сценарии и проверьте результаты простыми фразами в любом MCP-клиенте. В Claude Desktop и Claude Code работает уже сейчас. Модели и расчёты остаются на вашей рабочей станции.

v 0.2.0-dev6· macOS · Windows · Linux· Apache-2.0· бесплатно
Открыть 3D-сцену →
Norne · phi · 44 927 active · Statoil / OPM · ODbL-1.0
Модели и расчёты — на вашей станции· Работает рядом с Petrel и RMS· Каждый результат — с независимой проверкой· Открытый код на GitHub · Apache-2.0

Числа считает код, а не языковая модель.
Допущения подтверждаете вы.

Принцип Kanysh Basic
§ 01 / Концепция

Не замена Petrel.
Второй пилот
рядом с ним.

Модель строится там, где вы привыкли. Kanysh Basic берёт выгруженные файлы — DATA/GRDECL, поверхности, скважины, LAS — и делает то, что обычно уходит на Excel и ручные проверки: объёмы по регионам, сценарии, сверку и QC. Управление одно — разговор.

Задача
Вручную · Petrel + Excel
Kanysh Basic
Запуск расчёта
Настройка процесса в меню, перенос параметров между вкладками
Одна фраза в чате. Агент сам выбирает инструмент.
Допущения
Спрятаны в настройках проекта и чужих Excel-файлах
Предложения с файлом и строкой. Без вашего подтверждения расчёт не начнётся.
Проверка
Пересчёт «на глаз» или вторым методом вручную
Независимая проверка каждого результата: PASS / FAIL / NOT RUN.
История
Проект перезаписывается, версии теряются
Неизменяемые ревизии входов и результатов.
Сверка
Сведение таблиц Petrel и RMS вручную
Сверка с CSV и объяснение причин расхождений.
Отчёт
Скриншоты и ручное оформление
HTML, Excel, PDF — с допущениями и статусами.
Язык
English
Любой язык вашего MCP-клиента.
§ 02 / Сценарии

Одна фраза —
один расчёт.

Пять базовых сценариев — готовые prompts MCP, плюс большие модели и запуск вашего дека в OPM Flow. Названия инструментов учить не нужно: опишите задачу своими словами, агент подберёт инструмент и спросит недостающее.

check_model

Проверка модели

«Проверь модель и покажи проблемы с severity и IJK»

  • импорт DATA/GRDECL, INCLUDE, BOX/EQUALS/COPY
  • вырожденные и перекрученные ячейки
  • находки не исправляются молча

regional_volumes

Объёмы по регионам

«Посчитай нефть и свободный газ по EQLNUM с моими контактами»

  • STOIIP и GIIP по регионам
  • ВНК/ГНК, Bo/Bg, остаточные насыщенности
  • функции Sw по высоте, полигоны

reconcile_petrel

Сверка с Petrel/RMS

«Сверь объёмы с CSV из Petrel и объясни расхождения»

  • явное сопоставление метрик и единиц
  • возможные причины отделены от доказанных
  • входные данные не меняются

tornado_analysis

Чувствительность

«Построй торнадо по пористости для двух регионов»

  • торнадо по заданным вами диапазонам
  • коррелированный Монте-Карло с seed
  • неудачные прогоны не пересэмплируются

compare_versions

Сравнение ревизий

«Сравни две версии модели и влияние на поровый объём»

  • изменённые ячейки при одинаковом IJK
  • влияние по регионам
  • скважины vs модель по LAS

экспорт

Отчёты и 3D

«Выгрузи отчёт в Excel и PDF и покажи модель в 3D»

  • HTML, JSON, CSV, PNG, Excel, PDF
  • офлайн 3D-сцена в браузере
  • статусы ISSUES / NOT RUN сохраняются

eclipse_import

Большие модели

«Импортируй EGRID и INIT и проверь модель»

  • потоковый импорт ASCII DATA и бинарного EGRID/INIT
  • проверено на 200 млн ячеек
  • GPU-сборка: объёмы на CUDA со сверкой на CPU

simulation_deck_run

Гидродинамика в OPM Flow

«Запусти мой дек в OPM Flow и сравни с ECLIPSE»

  • ваш .DATA и INCLUDE — как есть, без правок
  • Linux или Windows через WSL2
  • сводка SMSPEC → Parquet, сверка с эталоном
§ 03 / Как работает

Агент спрашивает. Вы подтверждаете. Код считает.

LLM в вашем MCP-клиенте понимает задачу и вызывает типизированные инструменты Kanysh Basic. Сами числа считает проверенный Python-код на CPU вашей машины, а результат проверяется независимым методом.

  • 01 — ПапкаВы добавляете папку с выгрузкой. Kanysh видит только то, что вы разрешили.
  • 02 — Разборfolder_assess находит роли файлов и предлагает контакты, PVT и единицы — с файлом и строкой.
  • 03 — ПодтверждениеВы подтверждаете или правите допущения. Недостающие константы не подставляются.
  • 04 — РасчётЗадача с журналом; входы и результаты сохраняются как неизменяемые ревизии.
  • 05 — ОтчётНезависимые проверки, статусы PASS / ISSUES / NOT RUN, экспорт в Excel и PDF.
Norne · настоящий прогон через MCP# Геолог: "Посчитай нефть и газ по EQLNUM 1 и 3. ВНК −2692 / −2618 м, ГНК −2582 м, Bo 1.2, Bg 0.005, Sw 0.25 — подтверждаю" # Агент: folder_assess(source="norne") ↳ EQUIL: E3.prop, строки 18, 20 — предложение eclipse_import(...) ↳ 113 344 ячейки · 44 927 активных model_qc(...) ↳ ISSUES · 243 вырожденных, 1 перекрученная regional_volumes(regions=[1, 3], ...) # Ответ: EQLNUM 1 STOIIP 9 347 774 ст. м³ EQLNUM 3 STOIIP 2 860 856 ст. м³ Итого STOIIP 12 208 630 ст. м³ GIIP 6,197 млрд ст. м³ независимая проверка: PASS
§ 04 / Архитектура

Разговор — в вашем клиенте.
Расчёт — на вашей машине.

Kanysh Basic — это локальный MCP-сервер и офлайн-просмотрщик. Встроенной LLM и облака в нём нет. Какие сообщения уходят AI-провайдеру, решает ваш MCP-клиент.

Диалог

MCP-клиент
  • Claude Desktop, Claude Code — готово сейчас
  • Codex, Cursor и другие — через stdio
  • ChatGPT — через Secure MCP Tunnel, в планах
  • Вы выбираете AI-провайдера и что ему отправлять

Kanysh Basic

Локальный MCP-сервер
  • Python 3.12 · официальный MCP SDK
  • Типизированные инструменты и длительные задачи
  • Неизменяемые ревизии и журнал задач
  • Независимые численные проверки
  • Пулы процессов CPU · опционально CUDA
  • Офлайн-просмотрщик · REST API · CLI

Данные

Ваши выгрузки
  • Eclipse DATA / GRDECL · EGRID / INIT · .GRID
  • Поверхности IRAP, ZMAP+, CPS-3
  • Скважины RMS; траектории, разбивки и полигоны Petrel ASCII
  • LAS · CSV · ROFF
  • Poststack SEG-Y → тайлы Zarr
ГЕОЛОГ  ⟶  MCP-КЛИЕНТ  ⟶  KANYSH BASIC  ⟶  ВАШИ ФАЙЛЫ  ⟶  ОТЧЁТ С ПРОВЕРКАМИ
§ 05 / Демо

Norne: открытые данные,
настоящий расчёт.

Публичная модель месторождения Norne (Statoil / OPM): 113 344 ячейки, 44 927 активных. Весь путь, от разбора папки до PDF, прошёл через настоящий MCP. Параметры флюидов — явные демо-допущения, а не оценка запасов.

Norne porosity, 3D scene
Пористость · все 44 927 активных ячеек
Объёмы по регионам EQLNUM 1 и 3
EQLNUM Ячеек ВНК, м STOIIP, ст. м³ GIIP, млн ст. м³
14 22426929 347 7745 375
31 29626182 860 856822
Итого5 520—12 208 6306 197
Торнадо STOIIP · пористость ×0,9–1,1
EQLNUM 111.27 – 13.14
EQLNUM 311.92 – 12.49
база 12,21 млн ст. м³

QC модели: ISSUES — 243 вырожденные и 1 перекрученная ячейка. Они не удаляются скрытно: объёмы посчитаны для регионов 1 и 3, совместимых с QC. Демо-допущения: Bo 1,2, Bg 0,005, Sw 0,25. Данные Norne: Statoil / OPM, ODbL-1.0 / DbCL-1.0.

§ 06 / Масштаб

От Norne до 200 млн ячеек.
И настоящие данные Volve.

Мы проверяем Kanysh Basic не только на демо. Синтетическая corner-point модель на 200 млн ячеек проходит весь путь на обычном ноутбуке, а реальная модель Equinor Volve показала, где мы совпадаем с ECLIPSE и где ещё есть пробелы.

200 млн ячеек · синтетика
Этап Время Пик RAM
Импорт DATA/COORD/ZCORN17,7 мин12,1 GiB
QC модели12,3 мин2,6 GiB
Объёмы по регионам14,6 мин2,1 GiB
Торнадо13,8 мин2,1 GiB

Ноутбук: 16 потоков, 64 ГБ RAM, Windows 11, расчёт на CPU. Один прогон; все проверки PASS, три намеренно испорченные ячейки исключены явно. Методика и сырые данные.

Equinor Volve · реальные данные
  • 680 400 ячеек, 183 545 активных — ровно как у ECLIPSE после MINPV/PINCH
  • Поровый объём против ECLIPSE PORV: медианное расхождение 3,4·10⁻⁵ с учётом множителей дека
  • Дек в OPM Flow: 339 отчётных шагов до 2016 г. за 35 мин. Начальные запасы совпадают, давление — в пределах 0,46 %, накопленная добыча — 0,9 %
  • Найдены и исправлены пробелы парсера: MAXVALUE/MINVALUE, MULTIREG. ADDZCORN пока не поддерживается, импорт отказывает явно

Данные Equinor Volve (Equinor Open Data Licence) с Kanysh не распространяются. Чтобы OPM принял дек, в нём сделали 3 документированные правки; ADDZCORN и PRIORITY OPM проигнорировал. Полный отчёт.

§ 07 / Установка

Один файл.
Три шага.
Первое слово — «begin».

Для Claude Desktop — расширение .mcpb, установка в один клик. Для остальных MCP-клиентов тот же архив запускается как обычный stdio-сервер. Python-зависимости ставит uv; в архиве — код и публичное демо Norne, никаких чужих данных.

01 · Скачать
Скачайте файл .mcpb
Обычная сборка — CPU, 14,0 МБ. Для видеокарт NVIDIA есть отдельная GPU-сборка (CUDA 12.6, при первой установке скачивает около 2,5 ГБ); обе можно поставить рядом. macOS, Linux и Windows — нативно, без WSL; установка на реальном Windows ещё проверяется: инструкция для Windows.
↳ ~1 минута
02 · Установить
Откройте его в Claude Desktop
Клиент установит зависимости, для этого нужны сеть и место на диске. Укажите папку для результатов и, по желанию, папку с выгруженной моделью — к ней будет доступ только на чтение.
↳ Claude Desktop · несколько минут
03 · Начать
Выберите prompt «begin»
Агент расскажет, что умеет. Добавьте папку с выгрузкой или откройте демо Norne: сохранённые результаты без пересчёта.
↳ можно работать
Другие MCP-клиенты

Codex, Cursor и другие

Склонируйте репозиторий, установите зависимости через uv (нужен Python 3.12) и пропишите stdio-сервер в конфигурации клиента (на Windows путь — .venv\Scripts\kanysh-basic.exe). Без git тоже можно: файл .mcpb — обычный zip, его достаточно распаковать и запустить uv run --directory <папка> server.py.

ChatGPT в браузере и приложении подключает только удалённые MCP-серверы по HTTPS, локальный сервер ему недоступен. Подключение через OpenAI Secure MCP Tunnel — в планах.

shellgit clone https://github.com/almukhanomr/kanysh && cd kanysh uv python install 3.12 uv sync --frozen --no-dev --extra ui --extra viewer --python 3.12 # Claude Desktop / Claude Code: uv run --no-sync kanysh-basic setup
JSON · Cursor, Claude Desktop вручную и большинство клиентов{ "mcpServers": { "kanysh-basic": { "command": "/path/to/kanysh/.venv/bin/kanysh-basic", "args": ["--home", "/path/to/state", "mcp", "--profile", "agent"] } } }
Codex · ~/.codex/config.toml[mcp_servers.kanysh-basic] command = "/path/to/kanysh/.venv/bin/kanysh-basic" args = ["--home", "/path/to/state", "mcp", "--profile", "agent"] startup_timeout_sec = 120
Kanysh Basic · 0.2.0-dev6v0.2.0-dev6 release github.com/almukhanomr/kanysh · v0.2.0-dev6 ↗ manifest MCPB v0.4 · uv runtime · python >=3.12 <3.13 platform win32 · darwin · linux license Apache-2.0 cpu kanysh-basic-0.2.0-dev6.mcpb · 13 977 034 B sha256 1c52a8c8753cc74eaa7150719540e935554c0c411cf9aa00148456c5325f6a58 gpu kanysh-basic-gpu-0.2.0-dev6.mcpb · 13 983 348 B · CUDA 12.6 sha256 312b9107cafc1e1e736771a00eec5f1c2d6cce7186094470dd1042bbdc717b54 status ранний релиз · Claude Desktop и Claude Code — готово; другие MCP-клиенты — через stdio
§ 08 / Границы

Честно о том,
чего Basic не делает.

Численный PASS не заменяет геологическую экспертизу. Вот где сейчас проходят границы.

§ 09 / Kanysh Advanced

Дальше — геологическая
станция, управляемая
разговором.

Kanysh Advanced — следующий шаг: AI-нативная рабочая станция в браузере, на GPU-сервере заказчика, поверх OSDU. Сейсмика, скважины, моделирование — через диалог с агентом. Это направление разработки, а не обещанные сроки: в Basic этих функций нет.

Сейчас
Basic
принят · 0.2.0-dev6

MCP-копилот рядом с Petrel/RMS: импорт, QC, объёмы, сверка, чувствительность, отчёты.

Advanced
Моделирование
в планах

Структурные модели с несколькими горизонтами и разломами, апскейлинг каротажа, фации и пространственное моделирование свойств, корреляция скважин.

Advanced
Масштаб и сервер
в планах

Большие ROFF, удалённые GPU-вычисления, S3 и OSDU, серверный рендеринг больших сцен, интерпретация сейсмики.

Advanced
Динамика
в планах

Basic уже запускает ваш готовый дек в OPM Flow. Дальше: построение гидродинамической модели, адаптация истории (ES-MDA), ансамбли и оптимизация плана разработки.

концепт интерфейса Kanysh Advanced
Kanysh
project: Tengiz-East  ·  OSDU: connected
● GPU · 71% VRAM · allocated geologist
⬡ ◈ ⌇ ▦ ≋ ⊞
inline 1247 · crossline 3204 tile · seismic/tengiz/1247.png z: t-domain · 0—5200 ms
Top Triassic · auto-tracked
SDMS stream CDP 4120 ────────────────── 4380 colormap: copper
Agent · LangGraph live
геолог
Покажи inline 1247 по Тенгизу и протяни верхний триас.
→ osdu_get_seismic(survey="tengiz-east", inline=1247)
→ track_horizon(name="Top Triassic", method="seisnet")
kanysh
Срез отрисован. Top Triassic протянут на 92% площади, неуверенные зоны подсвечены — посмотри в районе CDP 4280. Сохранить горизонт в OSDU?
геолог
Посчитай пористость по Wyllie для KZ-12 в этом интервале.
● _ ↵
Tengiz-East · OSDU · 4 wells · queue: 2 jobs online
§ 10 / Партнёрство

Ищем пилоты
и партнёров для Advanced.

Basic показывает работающее ядро: проверяемые расчёты из разговора. Мы открыты к пилотам на реальных моделях, к разговору с инвесторами и стратегическими партнёрами, особенно с теми, кто знает процессы Petrel/RMS, OSDU и нефтегазовую интерпретацию.

Связаться →
§ 11 / FAQ

Частые вопросы.

Коротко: что это, где данные, что нужно для запуска.

+Что такое Kanysh Basic?
Это AI-копилот для расчётов по геологическим моделям, который работает рядом с Petrel и RMS. Технически это локальный MCP-сервер с офлайн-просмотрщиком: вы общаетесь в своём MCP-клиенте (например, Claude Desktop или Claude Code), а Kanysh Basic импортирует выгруженные модели, считает объёмы и сценарии и возвращает отчёты с независимыми проверками.
+Он заменяет Petrel или RMS?
Нет. Модель вы строите как обычно. Kanysh Basic работает с выгруженными файлами (DATA/GRDECL, EGRID/ROFF, поверхности, скважины, LAS, CSV) и берёт на себя расчёты и проверки, которые обычно уходят в Excel. Нативные базы проектов Petrel и RMS не поддерживаются.
+Куда уходят мои данные?
Модели, расчёты и результаты остаются на вашей рабочей станции. У Kanysh Basic нет облака и встроенной LLM. Тексты диалога и результаты инструментов видит AI-провайдер вашего MCP-клиента; что именно ему отправлять, решаете вы и настройки клиента.
+Работает ли с ChatGPT?
Kanysh Basic — стандартный MCP-сервер, поэтому работает с клиентами, которые запускают локальные MCP-серверы: Claude Desktop, Claude Code, Codex, Cursor и другими. ChatGPT в браузере и приложении подключает только удалённые серверы по HTTPS, а localhost вашей станции ему недоступен. Подключение через OpenAI Secure MCP Tunnel — в планах; вычисления при этом останутся на станции.
+Может ли AI ошибиться в цифрах?
Числа считает не языковая модель, а детерминированный Python-код, и каждый результат проверяется независимым методом. Параметры, найденные в файлах, — только предложения со ссылкой на файл и строку: без вашего подтверждения расчёт не запускается, а недостающие константы не подставляются.
+Что нужно для запуска?
Любой MCP-клиент, который запускает локальные серверы. Проще всего — Claude Desktop (расширение .mcpb) или Claude Code: готово к работе уже сейчас. Codex, Cursor и другие подключаются через stdio. Подойдут macOS, Linux или Windows и сеть для первой установки зависимостей. GPU не обязателен: по умолчанию расчёты идут на CPU, для NVIDIA есть отдельная GPU-сборка. Как установить.
+Можно ли запускать гидродинамику?
Да, опционально. Инструмент simulation_deck_run запускает ваш готовый ECLIPSE-дек в OPM Flow ровно в том виде, в каком он есть: без генерации и подстановки значений. Нужен Linux или Windows с WSL2 — kanysh-basic setup-opm ставит OPM в отдельный дистрибутив и проверяет его на SPE1. Без настроенного OPM запрос честно отказывает с инструкцией. Построение гидродинамической модели и адаптация истории — это уже Kanysh Advanced.
+Сколько стоит?
Kanysh Basic бесплатен, распространяется под лицензией Apache-2.0, исходный код открыт на GitHub. Пилот на ваших моделях и Kanysh Advanced обсудим отдельно: напишите нам.
+А что с OSDU, сейсмикой и GPU-сервером?
Это Kanysh Advanced, следующий этап: AI-нативная рабочая станция в браузере, на GPU-сервере заказчика, поверх OSDU. Сейчас это направление разработки; в Basic этих функций нет. Подробнее.
Kanysh Basic · v 0.2.0-dev6

Скачайте .mcpb.
Напишите «begin».
Дальше — расчёт.