Heracleum Scaffold MCP Server
Officialby 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; сами модели обучаются заново. Эти разбиения не выдаются за предоставленные авторами статьи файлы.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues