Mengonversi gambar struktur kimia menjadi string SMILES menggunakan DECIMER API.
Juga dikenal sebagai DocMinus/DecimerMCPServer, decimermcpserver, decimer-mcp-server
- Stars
- 0
- Tools
- 2
- Unduhan, 30 hari
- 163
- Versi terbaru
- 0.1.4
- Commit terakhir
- 22 Okt 2026
- Lisensi
- MIT
Apa itu DECIMER MCP?
Mengonversi gambar struktur kimia menjadi string SMILES menggunakan DECIMER API. Server ini menyediakan 2 tool, seperti server_health, analyze_chemical_image.
Ringkasan dibuat dari README proyek
Tentang DECIMER MCP server
Mengonversi gambar struktur kimia menjadi string SMILES adalah fungsi utama dari tool ini. Tool ini bertindak sebagai adapter ringan untuk layanan DECIMER FastAPI, yang memungkinkan klien AI berinteraksi dengan kemampuan pengenalan gambar kimia melalui tool calls standar. Anda harus memiliki server DECIMER API yang sedang berjalan, yang secara default berada di localhost pada port 8099, untuk menggunakan server ini.
Developer dapat mengelola koneksi menggunakan tool analyze_chemical_image untuk mengirim gambar dalam format base64-encoded untuk diproses. Server ini juga menyertakan tool server_health untuk memverifikasi apakah layanan FastAPI jarak jauh dapat dijangkau. Konfigurasi dikelola melalui environment variables, termasuk pengaturan untuk API base URL, request timeouts, dan ukuran byte gambar maksimum. Setup ini dirancang untuk integrasi lokal via transport stdio menggunakan Python 3.10 atau versi yang lebih tinggi.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal DECIMER MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal DECIMER MCP di Claude Code
$ claude mcp add decimermcpserver -- uvx decimer-mcp-serverInstal DECIMER MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"decimermcpserver": {
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Instal DECIMER MCP di VS Code
.vscode/mcp.json
{
"servers": {
"decimermcpserver": {
"type": "stdio",
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Instal DECIMER MCP di VS Code CLI
$ code --add-mcp '{"name":"decimermcpserver","type":"stdio","command":"uvx","args":["decimer-mcp-server"]}'Instal DECIMER MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"decimermcpserver": {
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Instal DECIMER MCP di Codex
$ codex mcp add decimermcpserver -- uvx decimer-mcp-serverInstal DECIMER MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.decimermcpserver] command = "uvx" args = ["decimer-mcp-server"]
Instal DECIMER MCP di Gemini CLI
$ gemini mcp add -s user decimermcpserver uvx -- decimer-mcp-serverInstal DECIMER MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"decimermcpserver": {
"command": "uvx",
"args": [
"decimer-mcp-server"
]
}
}
}Tool DECIMER MCP 2
Terdeteksi dari READMEserver_healthanalyze_chemical_image
| server_health | — | |
| analyze_chemical_image | — |
Konfigurasi
DECIMER_API_BASE_URL
| Nama | Deskripsi | Tipe |
|---|---|---|
| DECIMER_API_BASE_URL | — |
Pengecekan otomatis
Berjalan 12 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di 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.
Pertanyaan tentang DECIMER MCP
Bagaimana cara menambahkan DECIMER MCP ke Claude Code?
Jalankan claude mcp add decimermcpserver -- uvx decimer-mcp-server di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan DECIMER MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan DECIMER MCP?
Server ini menyediakan 2 tool, termasuk server_health, analyze_chemical_image.
Apakah server ini menjalankan model DECIMER secara langsung?
Tidak, server ini berfungsi sebagai adapter ringan untuk layanan FastAPI yang sudah ada dan tidak menjalankan model itu sendiri.
Apa saja persyaratan untuk menjalankan server ini?
Anda memerlukan Python 3.10 atau versi yang lebih tinggi serta server DECIMER API yang sedang berjalan.