Skip to main content
Glama
Heracleum Scaffold MCP Server

Heracleum Scaffold MCP Server

Official
by chemagents
README.md
# Heracleum — фуранокумарины

Рабочий MCP-сервер для [статьи](https://doi.org/10.3390/ijms27177947): **8 научных инструментов** и 9 запросов для проверки CoScientist. Аудит данных и идентичности, каркасы, PCA докинга и токсикологических прогнозов, редокинг, перестановочные тесты, RF/ElasticNet с random/scaffold CV, приоритизация и сравнение с таблицей S4.

Химические расчёты, статистика, данные и экспорт находятся в общей библиотеке [chem-repro-suite](https://github.com/chemagents/chem-repro-suite). Этот репозиторий закрепляет её commit `a2d980330bd90275722d401c6c9ca246a536dd01`; копии научного кода между серверами не расходятся.

## Быстрый запуск

Нужны Python 3.12 и uv.

```bash
git clone https://github.com/chemagents/heracleum-scaffold-mcp-server.git
cd heracleum-scaffold-mcp-server
uv sync --frozen --python 3.12
uv run heracleum-scaffold-mcp-server
```

Streamable HTTP: `http://127.0.0.1:7342/mcp`. Ключ LLM серверу не нужен. Артефакты возвращаются с URL, размером и SHA-256. Для хранения результатов задайте `CHEM_REPRO_ARTIFACTS_DIR`; при удалённом размещении — `CHEM_REPRO_PUBLIC_BASE_URL`, доступный клиенту.

Проверка реального запуска, списка инструментов, вызова и скачивания файлов:

```bash
uv run python scripts/smoke_server.py --study heracleum
```

## CoScientist

Из настроенного checkout CoScientist с работающим реестром MCP:

```bash
uv run python -m scripts.rag_tools.cli load /absolute/path/heracleum-scaffold-mcp-server/rag_registration.json
```

Измените адрес в JSON, если сервер размещён на другой машине. CoScientist выполняет планирование и формирует отчёт. Стандартный MCP-интерфейс и научный backend проверяются отдельно от качества текста агента: полная приёмка всех сквозных сценариев ещё продолжается.

`cases/prompts.jsonl` содержит 9 исходных вопросов, `cases/cases.json` — ожидаемые методы и проверки. Численные эталоны из файла проверок не следует добавлять в запрос модели.

## Границы воспроизведения

- По умолчанию используется `strict`. Для численной сверки опубликованной выборки явно задайте `identity_policy="published_snapshot"`.
- Сохраняются 65 конфликтов идентичности. Снимок даёт Tier 1/2/3 = 21/24/57; строгий режим — 18/10/9 и 65 записей без ранга.
- Выходы ADMETlab не являются экспериментальной токсичностью. Совпадение структурных и расчётных профилей не является биологической валидацией.
- Утверждение статьи о пабулариноне 8/8 не совпадает с пересчётом 7/8. Названия и структуры не меняются для подгонки результата.
- Опубликованная таблица восстановления поз и новая публичная реконструкция докинга — разные режимы. Новый редокинг требует отдельного окружения и точного Vina 1.2.5; подготовленные авторские файлы и сырые активные/неактивные контроли недоступны.

Данные и их источники закреплены манифестами общей библиотеки. Ошибки источников, реконструкции и опубликованные сведения возвращаются явно. Статусы установочной проверки находятся в `validation/`; полный отчёт об апробации будет дополнен после сквозных прогонов.

Численная валидация использует зафиксированные разбиения эталонного запуска реализации. Это устраняет различие распределения равных по размеру групп между macOS и Linux; сами модели обучаются заново. Эти разбиения не выдаются за предоставленные авторами статьи файлы.