Thermo Orbitrap (Instrument API) — MCP-сервер для Claude Code
Мост между ИИ-агентом и масс-спектрометрами Thermo Orbitrap через официальный Instrument API. Позволяет считывать профили сканирования и управлять съёмкой данных.
claude mcp add --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> --transport stdio thermo-iapi -- uvx labmcp-thermo-iapiЧто делает Thermo Orbitrap (Instrument API)
Сервер связывает агента с масс-спектрометрами Orbitrap семейств Tribrid, Exploris (кроме модели 120) и Q Exactive через .NET API от Thermo Fisher Scientific. Модель может запрашивать статус вакуума, читать поток спектров с фильтрацией по порядку MS, ставить одиночные или повторяющиеся сканы и начинать запись в файл raw.
Для запуска на компьютере спектрометра под Windows нужен Python 3.10+ и пакет pythonnet. Самих библиотек Thermo в репозитории нет из-за юридических ограничений. Пользователь обязан сам получить подписанное лицензионное соглашение IAPI, установить софт Tune и скопировать нужные DLL в рабочую папку.
Код проверялся только на программном симуляторе FakeOrbitrap и пока не тестировался на реальном оборудовании. Для отладки без спектрометра доступен флаг --simulate, имитирующий Exploris 480, Eclipse или Q Exactive HF. При этом приборы Orbitrap Astral данным API не поддерживаются вовсе.
Какие задачи решает
- считывать показатели вакуума и режим спектрометра в реальном времени
- запускать и останавливать сбор данных в raw-файл
- настраивать одиночные и циклические сканы через IAPI
- отслеживать поток спектров с фильтрацией центроидов
- тестировать автоматизацию прибора на симуляторе без доступа к спектрометру
Примеры запросов агенту
- Проверь текущий статус спектрометра и давление вакуума
- Запусти симуляцию Exploris 480 и покажи последние зарегистрированные сканы MS1
- Отмени все ожидающие кастомные сканы на приборе
Как установить Thermo Orbitrap (Instrument API)
Командой платформы
claude mcp add --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> --transport stdio thermo-iapi -- uvx labmcp-thermo-iapiВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-thermo-iapi <команда>
Командой платформы
codex mcp add thermo-iapi --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> -- uvx labmcp-thermo-iapiВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-thermo-iapi <команда>
Файл настроек
{
"mcpServers": {
"thermo-iapi": {
"command": "uvx",
"args": [
"labmcp-thermo-iapi"
],
"env": {
"LABMCP_ADDRESS": "<LABMCP_ADDRESS>",
"LABMCP_SIMULATE": "<LABMCP_SIMULATE>",
"LABMCP_READ_ONLY": "<LABMCP_READ_ONLY>",
"LABMCP_LIMITS": "<LABMCP_LIMITS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-thermo-iapi <команда>
Файл настроек
{
"servers": {
"thermo-iapi": {
"type": "stdio",
"command": "uvx",
"args": [
"labmcp-thermo-iapi"
],
"env": {
"LABMCP_ADDRESS": "<LABMCP_ADDRESS>",
"LABMCP_SIMULATE": "<LABMCP_SIMULATE>",
"LABMCP_READ_ONLY": "<LABMCP_READ_ONLY>",
"LABMCP_LIMITS": "<LABMCP_LIMITS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-thermo-iapi <команда>
Командой платформы
gemini mcp add -e LABMCP_ADDRESS=<LABMCP_ADDRESS> -e LABMCP_SIMULATE=<LABMCP_SIMULATE> -e LABMCP_READ_ONLY=<LABMCP_READ_ONLY> -e LABMCP_LIMITS=<LABMCP_LIMITS> thermo-iapi uvx labmcp-thermo-iapiВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from labmcp-thermo-iapi <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Thermo Orbitrap (Instrument API)
Как установить Thermo Orbitrap (Instrument API) в Claude Code?
Выполните в консоли команду: claude mcp add labmcp-thermo-iapi -- uvx labmcp-thermo-iapi.
Что нужно для работы с реальным прибором?
Требуется управляющий компьютер под Windows с запущенным Tune, Python 3.10+ с пакетом pythonnet и подписанная лицензия Thermo Fisher IAPI. Библиотеки .NET необходимо скопировать с прибора в отдельный каталог.
Можно ли протестировать сервер без спектрометра?
Да, флаг --simulate запускает виртуальный Orbitrap Exploris 480. Симулятор генерирует синтетические спектры триптического гидролиза и отдаёт реалистичные показания вакуума.
