ketcher-mcp-server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Ketcher MCP Server
MCP (Model Context Protocol) server for Ketcher chemical structure editor integration with Claude.
Features
๐งช Open Ketcher Editor: Launch Ketcher web interface in browser
๐ Format Conversion: Convert between SMILES, MOL, InChI formats
๐ผ๏ธ Image Generation: Generate PNG/SVG images from SMILES
๐ Molecular Properties: Calculate molecular weight, LogP, TPSA, etc.
โ Validation: Validate SMILES strings
Related MCP server: ChemDraw Server
Installation
Prerequisites
Python 3.10 or higher (tested with Python 3.11)
pip
Note: If you're using macOS with system Python 3.9, you'll need to install Python 3.10+ separately:
# Using Homebrew
brew install python@3.11
# Verify installation
/opt/homebrew/bin/python3.11 --versionInstall Dependencies
cd ketcher-mcp-server
# If using Python 3.11 from Homebrew
/opt/homebrew/bin/python3.11 -m pip install -e .
# Or if python3 is already 3.10+
pip install -e .For Development
pip install -e ".[dev]"Usage
Running the Server
python -m ketcher_mcp.serverOr use with mcp CLI:
mcp run ketcher_mcp.serverConfiguration for Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ketcher": {
"command": "/opt/homebrew/bin/python3.11",
"args": ["-m", "ketcher_mcp.server"]
}
}
}Note: Adjust the Python path based on your installation:
Homebrew Python 3.11:
/opt/homebrew/bin/python3.11System Python 3.10+:
python3orpython3.10Check your path with:
which python3.11
On macOS, the config file is located at:
~/Library/Application Support/Claude/claude_desktop_config.jsonAvailable Tools
1. open_ketcher
Opens Ketcher chemical structure editor in your default web browser.
Example:
Open Ketcher editor2. smiles_to_image
Converts SMILES notation to molecular structure image.
Parameters:
smiles(str): SMILES notationwidth(int, optional): Image width (default: 400)height(int, optional): Image height (default: 300)format(str, optional): 'png' or 'svg' (default: 'png')
Example:
Generate image for aspirin: CC(=O)Oc1ccccc1C(=O)O3. smiles_to_mol
Converts SMILES to MOL file format.
Parameters:
smiles(str): SMILES notation
Example:
Convert CC(=O)Oc1ccccc1C(=O)O to MOL format4. mol_to_smiles
Converts MOL file format to SMILES.
Parameters:
mol_block(str): MOL file content
5. get_molecule_properties
Calculates molecular properties from SMILES.
Parameters:
smiles(str): SMILES notation
Returns:
Molecular formula
Molecular weight
Number of atoms, bonds, rings
LogP, TPSA
Hydrogen bond donors/acceptors
Rotatable bonds
Example:
Get properties of caffeine: CN1C=NC2=C1C(=O)N(C(=O)N2C)C6. validate_smiles
Validates a SMILES string.
Parameters:
smiles(str): SMILES notation to validate
Example:
Validate SMILES: CCO7. smiles_to_inchi
Converts SMILES to InChI identifier.
Parameters:
smiles(str): SMILES notation
8. smiles_to_inchikey
Converts SMILES to InChIKey identifier.
Parameters:
smiles(str): SMILES notation
Example Workflows
Workflow 1: Draw and Analyze a Molecule
"Open Ketcher editor"
Draw your molecule in Ketcher
Copy the SMILES from Ketcher
"Get properties of [SMILES]"
"Generate image for [SMILES]"
Workflow 2: Convert Chemical Formats
"Convert aspirin SMILES to MOL format: CC(=O)Oc1ccccc1C(=O)O"
"Convert this MOL to InChI"
"Generate InChIKey"
Workflow 3: Validate and Visualize
"Validate SMILES: CCO"
"Generate SVG image for CCO"
"Get molecular properties"
Technical Details
Architecture
FastMCP: MCP server framework
RDKit: Chemical informatics library for molecule processing
Ketcher: Web-based chemical structure editor (via CDN)
Supported Formats
SMILES: Simplified Molecular Input Line Entry System
MOL: MDL Molfile format
InChI: IUPAC International Chemical Identifier
InChIKey: Hashed InChI for database lookups
PNG/SVG: Image formats for visualization
Troubleshooting
RDKit Installation Issues
If you encounter issues installing RDKit:
# Using conda (recommended)
conda install -c conda-forge rdkit
# Or using pip
pip install rdkit-pypiKetcher Not Opening
Make sure you have a default web browser configured. The server uses Python's webbrowser module.
Development
Running Tests
pytestProject Structure
ketcher-mcp-server/
โโโ ketcher_mcp/
โ โโโ __init__.py
โ โโโ server.py
โโโ pyproject.toml
โโโ README.mdContributing
Contributions are welcome! Please feel free to submit issues or pull requests.
License
MIT License
Acknowledgments
Ketcher - EPAM's open-source chemical structure editor
RDKit - Open-source cheminformatics toolkit
FastMCP - Fast MCP server framework
Version History
0.1.0 (2026-03-09): Initial release
Basic SMILES/MOL conversion
Image generation
Molecular property calculation
Ketcher integration
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server for 4chems hosted IUCLID, CHESAR and QSAR Toolbox: onboarding, inquiries, admin.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval.
MCP gateway federating 22 biomedical MCP servers behind one endpoint: gnomAD, ClinVar, HPO, VEP.
Related MCP Servers
FlicenseNot gradedqualityAmaintenanceProvides a collection of MCP servers for computational chemistry tasks including molecular generation and retrosynthesis. Also offers property prediction and molecule pricing capabilities.-- AlicenseNot gradedqualityDmaintenanceProvides chemical informatics endpoints for converting between chemical names and SMILES, processing molecule structures, and comparing molecules, with MCP compatibility.5MIT
- AlicenseBqualityCmaintenanceMCP server that exposes DECIMER image-to-SMILES functionality as tool calls.236 PyPIMIT
- FlicenseBqualityDmaintenanceMCP server for indexing and searching reaction-step-level synthesis routes from local SciFinder exports, designed for Docker/NAS deployment.32-