Преобразует изображения химических структур в строки SMILES с помощью DECIMER API.
Также известен как DocMinus/DecimerMCPServer, decimermcpserver, decimer-mcp-server
- Звёзды
- 0
- Инструменты
- 2
- Загрузки, 30 дней
- 163
- Последняя версия
- 0.1.4
- Последний коммит
- 22 окт. 2026 г.
- Лицензия
- MIT
Что такое DECIMER MCP?
Преобразует изображения химических структур в строки SMILES с помощью DECIMER API. Он предоставляет 2 инструмента, например server_health, analyze_chemical_image.
Сводка сгенерирована из README проекта
О DECIMER MCP server
Основная функция этого инструмента — преобразование изображений химических структур в строки SMILES. Он выступает в роли тонкого адаптера для сервиса DECIMER FastAPI, позволяя ИИ-клиентам взаимодействовать с возможностями распознавания химических изображений через стандартные вызовы инструментов. Для работы сервера у пользователей должен быть запущен сервер DECIMER API (по умолчанию доступен на localhost на порту 8099).
Разработчики могут управлять соединением с помощью инструмента analyze_chemical_image, отправляя изображения в формате base64 для обработки. Сервер также включает инструмент server_health для проверки доступности удаленного сервиса FastAPI. Конфигурация осуществляется через переменные окружения, включая настройки базового URL API, таймаутов запросов и максимального размера изображений в байтах. Данная архитектура предназначена для локальной интеграции через транспорт stdio с использованием Python 3.10 или выше.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить DECIMER MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка DECIMER MCP в Claude Code
$ claude mcp add decimermcpserver -- uvx decimer-mcp-serverУстановка DECIMER MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"decimermcpserver": {
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Установка DECIMER MCP в VS Code
.vscode/mcp.json
{
"servers": {
"decimermcpserver": {
"type": "stdio",
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Установка DECIMER MCP в VS Code CLI
$ code --add-mcp '{"name":"decimermcpserver","type":"stdio","command":"uvx","args":["decimer-mcp-server"]}'Установка DECIMER MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"decimermcpserver": {
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Установка DECIMER MCP в Codex
$ codex mcp add decimermcpserver -- uvx decimer-mcp-serverУстановка DECIMER MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.decimermcpserver] command = "uvx" args = ["decimer-mcp-server"]
Установка DECIMER MCP в Gemini CLI
$ gemini mcp add -s user decimermcpserver uvx -- decimer-mcp-serverУстановка DECIMER MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"decimermcpserver": {
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Инструменты DECIMER MCP 2
Определено из READMEserver_healthanalyze_chemical_image
| server_health | — | |
| analyze_chemical_image | — |
Конфигурация
DECIMER_API_BASE_URL
| Название | Описание | Тип |
|---|---|---|
| DECIMER_API_BASE_URL | — |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыПройдено
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на GitHubDecimerMCPServer
mcp-name: io.github.DocMinus/decimer-mcp-server
MCP server that exposes DECIMER image-to-SMILES functionality as tool calls.
This project is a thin adapter over the existing FastAPI service in DecimerServerAPI.
It does not run DECIMER models directly.
The adapter sends JSON requests by default, with automatic fallback to form payloads for compatibility.
Tools
server_health: Checks whether the DECIMER FastAPI server is reachable.analyze_chemical_image: Sends a base64-encoded image to/image2smiles/and returns structured output.
Requirements
- Python 3.10+
- Running DECIMER API server (default:
http://localhost:8099)
find it at either of these two versions:
- GitHub: https://github.com/DocMinus/DecimerServerAPI
- Dockerhub: https://hub.docker.com/r/docminus/decimer_api
Install
cd /Users/a/dev/DecimerMCPServer
uv venv
uv sync
Configuration
Copy .env.example values into your environment:
DECIMER_API_BASE_URL(defaulthttp://localhost:8099)DECIMER_API_TIMEOUT_SECONDS(default60)DECIMER_MAX_IMAGE_BYTES(default10000000)DECIMER_MCP_LOG_LEVEL(defaultINFO)
Run (stdio transport)
uv run decimer-mcp-server
or
uv run python -m decimer_mcp_server
Example MCP client config
{
"mcpServers": {
"decimer": {
"command": "uv",
"args": ["run", "python", "-m", "decimer_mcp_server"],
"env": {
"DECIMER_API_BASE_URL": "http://localhost:8099"
}
}
}
}
Output shape
analyze_chemical_image returns:
{
"ok": true,
"smiles": "CCO",
"reason": null,
"api_status_code": 200,
"api_message": null,
"classifier_score": 0.0000012,
"classifier_threshold": 0.3,
"classifier_decision": "structure_like"
}
When no SMILES is returned by API classifier behavior:
{
"ok": true,
"smiles": null,
"reason": "not_chemical_structure",
"api_status_code": 200,
"api_message": "No SMILES returned by API",
"classifier_score": 0.99999,
"classifier_threshold": 0.3,
"classifier_decision": "not_structure_like"
}
Development tests
uv sync --extra dev
uv run pytest
Make targets:
make sync
make test
Smoke test helper
Run one health check + one inference call against your DECIMER API:
cd /Users/a/dev/DecimerMCPServer
DECIMER_API_BASE_URL=http://chitchat:8099 uv run decimer-mcp-smoke-test --image /Users/a/dev/DecimerServerAPI/example_usage/structure.png
If you keep settings in .env, load it with:
uv run --env-file .env decimer-mcp-smoke-test --image /Users/a/dev/DecimerServerAPI/example_usage/structure.png
or use make:
make smoke
Override the image path if needed:
make smoke SMOKE_IMAGE=/absolute/path/to/image.png
## MCP Registry publishing
Tags matching `v*` trigger `.github/workflows/publish-mcp.yml`.
Workflow steps:
- installs `mcp-publisher`
- validates `server.json`
- calls registry publish using secret `MCP_REGISTRY_TOKEN`
- publishes slug `io.github.DocMinus/decimer-mcp-server` (case sensitive; must match registry grant)
Before tagging:
1. Update `pyproject.toml` + `server.json` versions
2. Ensure `server.json` stays valid (`uv pip install jsonschema && python validate snippet from AGENTS.md`)
3. Add GitHub repo secret `MCP_REGISTRY_TOKEN` (GitHub PAT with `repo`, `workflow` scopes)
Release flow:
```bash
git tag v0.1.1
git push origin v0.1.1
Monitor Actions tab. If publish fails, rerun using workflow dispatch after fixing issues.
## Contribution
This project was built by DocMinus with AI-assisted coding support (OpenCode/Copilot-style tooling), then reviewed and tested by the author.
## AI usage policy
- AI assistance was used for scaffolding, implementation drafts, and documentation edits.
- Final technical decisions, validation runs, and acceptance were performed by the maintainer.
- Runtime behavior should be validated with local tests (`make test`) and smoke tests (`make smoke`) before release.
Вопросы о DECIMER MCP
Как добавить DECIMER MCP в Claude Code?
Выполните claude mcp add decimermcpserver -- uvx decimer-mcp-server в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить DECIMER MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет DECIMER MCP?
Он предоставляет 2 инструмента, включая server_health, analyze_chemical_image.
Этот сервер запускает модели DECIMER напрямую?
Нет, этот сервер является тонким адаптером для существующего сервиса FastAPI и не запускает модели самостоятельно.
Какие требования для запуска этого сервера?
Вам потребуются Python 3.10 или выше и запущенный сервер DECIMER API.