Chembl MCP Server

🚀 ChEMBL-MCP-Server

A fast MCP wrapper server based on the chembl_webresource_client package, providing API access to the ChEMBL database.

🚀 Quick Start

The ChEMBL-MCP-Server is a powerful tool that offers API access to the ChEMBL database. Get started with the installation and usage steps below.

✨ Features

• Complete API access to the ChEMBL database.
• Asynchronous API calls using the FastMCP framework.
• Built-in error handling and timeout mechanisms.
• Support for HTTP and stdio transmission methods.
• Comprehensive type annotations and docstrings.

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/ChEMBL-MCP-Server.git
cd ChEMBL-MCP-Server

# Install dependencies
pip install -r requirements.txt

💻 Usage Examples

Starting the Server

# Start the HTTP server with default configuration
python chembl_searver.py

# Specify the host and port
python chembl_searver.py --host 0.0.0.0 --port 8080

# Use stdio transmission
python chembl_searver.py --transport stdio

# Set the log level
python chembl_searver.py --log-level DEBUG

Available Parameters

• --host: Server host address, default is 127.0.0.1.
• --port: Server port, default is 8000.
• --transport: Transmission method, options are http or stdio, default is http.
• --log-level: Log level, options are DEBUG, INFO, WARNING, ERROR, CRITICAL, default is INFO.

📚 Documentation

API Features

The server provides the following API features:

Data Entity API

• example_activity: Get activity data.
• example_assay: Get assay data.
• example_target: Get target data.
• example_molecule: Get molecule data.
• example_drug: Get drug data.
• More data entity APIs...

Chemical Tool API

• example_canonicalizeSmiles: Canonicalize SMILES strings.
• example_smiles2inchi: Convert SMILES to InChI.
• example_smiles2svg: Convert SMILES to SVG images.
• example_structuralAlerts: Get structural alert information.
• More chemical tool APIs...

Example

Check the chembl_search.py file for examples of using various APIs.

🔧 Technical Details

Dependencies

• chembl_webresource_client: ChEMBL web service client.
• mcp: MCP framework.
• fastapi: FastAPI framework.
• uvicorn: ASGI server.
• asyncio: Asynchronous I/O library.

📄 License

MIT