К основному содержанию
плагин CX Codex

contam-tools — плагин для Claude Code: CONTAM-проекты и установка

Плагин contam-tools подключает агента к локальному MCP-серверу CONTAM для проверки проектов, запуска симуляций и разбора результатов. Подходит для работы с файлами .prj и сценариями ContamW.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install contam-tools@awesome-codex-plugins
Открыть на GitHub

Что делает contam-tools

Плагин помогает изучать модели .prj, находить сломанные внешние ссылки, обновлять поддерживаемые пути и копировать базовые проекты в папки сценариев. Он также запускает contamx3.exe, собирает результаты, сравнивает файлы .sim и готовит текстовый вывод simread для разбора.

В комплект входят скилл для рабочих процессов Codex, локальный MCP-сервер и PowerShell-скрипты для проверки проекта. Защитный скрипт проверяет кодировку и профиль результатов, удаляет старые выходные файлы и выполняет базовые проверки. Для работы с ContamW настройки результатов должны быть GUI-safe; это важно учесть до передачи проекта другому пользователю.

Плагин рассчитан прежде всего на Windows. Он умеет искать установленные инструменты CONTAM, а при наличии может обнаружить привязки contamxpy и ANT для Rhino/Grasshopper. Для запуска MCP-сервера также приведён вариант с npx.

Какие задачи решает

  • проверить ссылки и метаданные в .prj
  • запустить ContamX и собрать выходные файлы
  • сравнить результаты в файлах .sim
  • подготовить проект к проверке в ContamW
  • разобрать текстовый вывод simread или XLog

Примеры запросов агенту

  • Проверь ссылки и период дат в этом файле .prj.
  • Запусти проверку проекта для ContamW и подготовь безопасный профиль результатов.
  • Запусти эту модель и перечисли созданные файлы.

Как установить contam-tools

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install contam-tools@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о contam-tools

Как установить contam-tools в Claude Code?

Сначала добавьте источник командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем установите плагин: /plugin install contam-tools@awesome-codex-plugins.

Что делает contam-tools?

Плагин подключает Claude Code и Codex к CONTAM через локальный MCP-сервер. Он проверяет .prj, запускает симуляции и помогает анализировать результаты.

Что нужно для запуска проекта в ContamW?

Перед передачей проекта запустите PowerShell-скрипт scripts/Invoke-ContamProjectGuard.ps1 с режимом InputCheck и профилем GuiSafeResults. Для Windows-проекта плагин также ищет исполняемые файлы CONTAM.

Исходный текст

CONTAM_plugin · MIT
# CONTAM Plugin

`CONTAM Plugin` is a Windows-first public toolkit for using CONTAM from AI coding agents and MCP-capable desktop tools.

It combines three layers in one repository:

- a local `stdio` MCP server for CONTAM command-line tools and ContamX bridge sessions
- a Codex plugin wrapper with workflow guidance for project creation, diagnosis, and simulation
- guard scripts for PRJ hygiene, ContamW-safe result settings, and optional `contam_chinese` linkage

The project is designed for public use. It helps an agent inspect `.prj` models, diagnose missing references, run simulations, compare outputs, generate simple ContamW SketchPad layouts, and separate solver failures from ContamW GUI result-display problems.

## Quick Use Through MCP

For most users, the easiest setup is an `npx`-launched local MCP server:

```text
command: npx
args: -y --package github:summer521521/CONTAM_plugin contam-mcp
```

The binary name remains `contam-mcp` because it launches the MCP server component. The repository and Codex plugin are named `CONTAM_plugin`.

Host-specific setup examples are in:

- [Host Setup Guide](docs/HOSTS.md)
- [Codex Windows App Setup](docs/CODEX_WINDOWS_APP.md)
- [Five-Minute Quickstart](docs/QUICKSTART.md)

## Codex Plugin Use

This repository can also be used as a Codex plugin source because the repository root contains:

- `.codex-plugin/plugin.json`
- `.mcp.json`
- `skills/contam-mcp/SKILL.md`
- `scripts/start-contam-plugin-mcp.ps1`
- `scripts/Invoke-ContamProjectGuard.ps1`

The plugin adds a CONTAM workflow skill that tells Codex to:

- inspect before editing
- keep case-specific data outside the plugin repository
- run ContamX input checks before GUI work
- keep only one active PRJ in a case folder unless scenarios are intentional
- use GUI-safe output settings when the user will run from ContamW
- record ContamW Building Check errors and fixes in case-local notes

## Main Capabilities

- discover bundled or configured CONTAM executables
- list `.prj`, `.sim`, `.wth`, `.ctm`, and related files
- inspect project metadata and external references
- diagnose broken project references
- update supported `.prj` file references
- clone baseline projects into named scenario folders
- create and optionally run small case matrices
- apply generated ContamW SketchPad layout data for rectangular rooms, zones, path icons, and source/sink icons
- run `contamx3.exe` and collect outputs
- run a PRJ guard for encoding, result profile, stale-output cleanup, XLog triage, and basic count checks
- discover and use optional `contamxpy` bindings for paper-style ContamX API co-simulation
- discover Rhino/Grasshopper ANT availability for model-creation workflows
- upgrade old `.prj` files with `prjup.exe`
- compare `.sim` files with `simcomp.exe`
- export `simread` text output
- summarize generic CONTAM text outputs for quick result triage
- start, inspect, advance, and close ContamX bridge sessions

## Project Guard

Before handing a generated PRJ to another user or asking someone to run it in ContamW, run:

```powershell
.\scripts\Invoke-ContamProjectGuard.ps1 `
  -ProjectPath "<case>\model.prj" `
  -Mode InputCheck `
  -ResultProfile GuiSafeResults `
  -CleanOutputs `
  -RequireSingleProject
```

For a command-line full run:

```powershell
.\scripts\Invoke-ContamProjectGuard.ps1 `
  -ProjectPath "<case>\model.prj" `
  -Mode Run `
  -ResultProfile GuiSafeResults
```

The guard does not prove a hand-drawn SketchPad layout is perfect, but it catches common project-sharing and simulation issues before the GUI step.

## Link With contam_chinese

`CONTAM_plugin` can use the localized executables distributed by [`contam_chinese`](https://github.com/summer521521/contam_chinese).

After extracting a `contam_chinese` release package, link it for the current PowerShell session:

```powershell
.\scripts\link-contam-chinese.ps1 -Path "<extracted-contam-chinese-release>"
```

Or persist it for your Windows user:

```powershell
.\scripts\link-contam-chinese.ps1 -Path "<extracted-contam-chinese-release>" -User
```

The launcher honors these variables in order:

- explicit tool overrides such as `CONTAMX_PATH`
- `CONTAM_HOME`
- `CONTAM_CHINESE_HOME`
- bundled executables in this repository

Use `contam_chinese` for localized ContamW and Chinese help. Use `CONTAM_plugin` for MCP automation, project checks, simulation workflows, and report-oriented result extraction.

## Repository Layout

- `.codex-plugin/`: Codex plugin manifest
- `.mcp.json`: MCP server launch definition for plugin hosts
- `skills/`: Codex workflow skill for CONTAM work
- `scripts/`: launch, guard, localization-link, setup, and maintenance scripts
- `contam-mcp/`: MCP server source, developer guide, and regression scripts
- `docs/`: public quickstart and host setup guides
- `.github/workflows/`: GitHub Actions workflows
- repository root: bundled CONTAM executables and supporting DLLs

## Privacy And CI

This repository includes a privacy check that scans tracked files for personal filesystem paths before public sharing:

```powershell
npm run privacy:check
```

Run the basic plugin launcher check with:

```powershell
npm run plugin:check
```

Run official regression cases with:

```powershell
npm run regression:official
```

## Example Prompts

- `Call discover_contam_installation and confirm CONTAM is available.`
- `List CONTAM case files in this folder.`
- `Inspect this PRJ file and summarize its references and date range.`
- `Run a test input only check for this PRJ.`
- `Make this PRJ safe for ContamW Building Check and result review.`
- `Run this PRJ and list the generated outputs.`
- `Apply a rectangular SketchPad layout to this PRJ so ContamW opens with visible rooms and icons.`
- `Run a small case matrix from this baseline model.`
- `Analyze this CONTAM xlog or simread text export.`
- `Discover whether contamxpy and ANT are available.`
- `Start a CONTAM bridge session for this project.`
- `Advance the active bridge session by 300 seconds and return path flow updates.`

## References

- [contam_chinese](https://github.com/summer521521/contam_chinese)
- [NIST CONTAM Download Page](https://www.nist.gov/el/energy-and-environment-division-73200/nist-multizone-modeling/software/contam/download)
- [NIST CONTAM Software Page](https://www.nist.gov/services-resources/software/contam)
- [NIST TN 1887r1](https://doi.org/10.6028/NIST.TN.1887r1)
- [Model Context Protocol](https://modelcontextprotocol.io/)

© summer521521 · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Наука и исследования» →
simulation-validator HeshamFS Скилл simulation-validator для Claude Code проверяет численные симуляции до, во время и после запуска. Разбирает сбои. CX Codex +1 ★ 95звёзд репо spice-sim diodeinc Скилл spice-sim для Claude Code настраивает и запускает симуляции схем Zener через ngspice с помощью команды pcb sim. CX Codex +1 1 300установок spice aklofas Скилл spice для Claude Code запускает SPICE-симуляции аналоговых узлов, найденных при анализе схемы KiCad. Он включается по просьбе проверить фильтр, делитель или усилительный каскад. CX Codex +1 790установок dod-vva-rpg jgsystemsconsulting По руководству DoD VV&A RPG. Помогает планировать верификацию, валидацию и аккредитацию военных моделей или симуляций без сторонних сервисов. CX Codex +1 ★ 93звёзд репо sim_critic официальный anthropics Промпт sim_critic для Claude Code проверяет Monte Carlo-модель клинического испытания по параметрам, коду и отчёту. На выходе он формирует замечания с приоритетами и вердикт по модели. GP ChatGPT ★ 654звёзд репо benchmark-and-mms-planner HeshamFS Скилл benchmark-and-mms-planner помогает составить план верификации и валидации расчётных кодов по методу искусственных решений (MMS), каноническим бенчмаркам и сеткам. CX Codex +1 ★ 95звёзд репо

Из того же набора391

Весь набор →
damnpdfs Подключает 71 инструмент для обработки PDF, офисных документов и картинок через вкладку DamnPDFs в браузере. CX Codex ★ 1 596звёзд репо court-rules Плагин court-rules для Claude Code и Codex ищет правила подачи документов в федеральные суды и суды штатов США, распоряжения судей и календарь судебных выходных. Ответы содержат ссылки на документы суда. CX Codex ★ 1 596звёзд репо coolify Плагин подключает Claude Code к облачному Coolify или самостоятельно развёрнутому экземпляру. Через него агент может проверять здоровье системы, запускать приложения, управлять переменными окружения и смотреть логи развёртываний. CX Codex ★ 1 596звёзд репо context-pack Плагин context-pack собирает краткую сводку по репозиторию для ИИ-агента за один проход. Экономит вызовы инструментов при первом знакомстве с кодовой базой. CX Codex ★ 1 596звёзд репо computer-usage-summary-skill Плагин computer-usage-summary-skill собирает отчёт по времени за компьютером из локального ActivityWatch: приложения, AFK, таймлайн и страницы в браузере. Данные не покидают машину. CX Codex ★ 1 596звёзд репо cometchat-skills Плагин подключает навыки интеграции текстового чата, голосовых и видеозвонков CometChat для React, Angular, React Native, iOS, Android и Flutter через официальный MCP с документацией. CX Codex ★ 1 596звёзд репо cohesivity Плагин подключает агента к сервисам Cohesivity: хостингу, Postgres, почте и другим инструментам. Доступ к ним идёт через MCP или API. CX Codex ★ 1 596звёзд репо codex-usage-tracker Плагин codex-usage-tracker для Claude Code собирает локальную статистику токенов Codex и выдаёт сводки, детали сессий, CSV и дашборды. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой