Skip to content
Back to search

ChEMBL-MCP-Server

A comprehensive Model Context Protocol (MCP) server providing advanced access to the ChEMBL chemical database.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/augmented-nature--chembl-mcp-server/badge.svg)](/listings/augmented-nature--chembl-mcp-server)

HTML

<a href="/listings/augmented-nature--chembl-mcp-server"><img src="/api/listings/augmented-nature--chembl-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Node.js (v16 or higher) - npm or yarn

Setup

1. Clone the repository:

git clone <repository-url>
cd chembl-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 500 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ![ChEMBL MCP Server Logo](chembl-mcp-server-logo.png)
  2. # **Unofficial** ChEMBL MCP Server
  3. A comprehensive Model Context Protocol (MCP) server providing advanced access to the ChEMBL chemical database. This server offers 22 specialized tools enabling AI assistants and MCP clients to perform sophisticated drug discovery research, chemical informatics analysis, and bioactivity investigations directly through ChEMBL's REST API.
  4. **Developed by [Augmented Nature](https://augmentednature.ai)**
  5. ## Features
  6. ### **Core Chemical Search & Retrieval (5 tools)**
  7. - **Compound Search**: Search the ChEMBL database by compound name, synonym, or identifier
  8. - **Detailed Compound Info**: Retrieve comprehensive compound information including structure, properties, and annotations
  9. - **InChI-based Search**: Find compounds by InChI key or InChI string
  10. - **Structure Retrieval**: Get chemical structure information in various formats (SMILES, InChI, MOL, SDF)
  11. - **Similarity Search**: Find chemically similar compounds using Tanimoto similarity
  12. ### **Target Analysis & Drug Discovery (5 tools)**
  13. - **Target Search**: Search for biological targets by name or type
  14. - **Detailed Target Info**: Retrieve comprehensive target information and annotations
  15. - **Target Compounds**: Get compounds tested against specific targets
  16. - **UniProt Integration**: Find ChEMBL targets by UniProt accession numbers
  17. - **Target Pathways**: Associated biological pathways and mechanisms
  18. ### **Bioactivity & Assay Data (5 tools)**
  19. - **Activity Search**: Search bioactivity measurements and assay results
  20. - **Detailed Assay Info**: Get comprehensive assay protocols and conditions
  21. - **Activity Type Search**: Find bioactivity data by specific activity type and value range
  22. - **Dose-Response Analysis**: Get dose-response data and activity profiles
  23. - **Activity Comparison**: Compare bioactivity data across multiple compounds or targets
  24. ### **Drug Development & Clinical Data (4 tools)**
  25. - **Drug Search**: Search for approved drugs and clinical candidates
  26. - **Drug Development Status**: Get drug development status and clinical trial information
  27. - **Therapeutic Indications**: Search for therapeutic indications and disease areas
  28. - **Mechanism of Action**: Get mechanism of action and target interaction data
  29. ### **Chemical Property Analysis (4 tools)**
  30. - **ADMET Analysis**: Analyze ADMET properties (Absorption, Distribution, Metabolism, Excretion, Toxicity)
  31. - **Molecular Descriptors**: Calculate molecular descriptors and physicochemical properties
  32. - **Solubility Prediction**: Predict aqueous solubility and permeability properties
  33. - **Drug-Likeness Assessment**: Assess drug-likeness using Lipinski Rule of Five and other metrics
  34. ### **Advanced Search & Cross-References (4 tools)**
  35. - **Substructure Search**: Find compounds containing specific substructures
  36. - **Batch Processing**: Process multiple ChEMBL IDs efficiently
  37. - **External References**: Get links to external databases (PubChem, DrugBank, PDB, etc.)
  38. - **Advanced Search**: Complex queries with multiple chemical and biological filters
  39. ### **Resource Templates**
  40. - Direct access to ChEMBL data via URI templates for seamless integration
  41. ## Installation
  42. ### Prerequisites
  43. - Node.js (v16 or higher)
  44. - npm or yarn
  45. ### Setup
  46. 1. Clone the repository:
  47. ```bash
  48. git clone <repository-url>
  49. cd chembl-server
  50. ```
  51. 2. Install dependencies:
  52. ```bash
  53. npm install
  54. ```
  55. 3. Build the project:
  56. ```bash
  57. npm run build
  58. ```
  59. ## Docker
  60. ### Building the Docker Image
  61. Build the Docker image:
  62. ```bash
  63. docker build -t chembl-mcp-server .
  64. ```
  65. ### Running with Docker
  66. Run the container:
  67. ```bash
  68. docker run -i chembl-mcp-server
  69. ```
  70. For MCP client integration, you can use the container directly:
  71. ```json
  72. {
  73. "mcpServers": {
  74. "chembl": {
  75. "command": "docker",
  76. "args": ["run", "-i", "chembl-mcp-server"],
  77. "env": {}
  78. }
  79. }
  80. }
  81. ```
  82. ## Usage
  83. ### As an MCP Server
  84. The server is designed to run as an MCP server that communicates via stdio:
  85. ```bash
  86. npm start
  87. ```
  88. ### Adding to MCP Client Configuration
  89. Add the server to your MCP client configuration (e.g., Claude Desktop):
  90. ```json
  91. {
  92. "mcpServers": {
  93. "chembl": {
  94. "command": "node",
  95. "args": ["/path/to/chembl-server/build/index.js"],
  96. "env": {}
  97. }
  98. }
  99. }
  100. ```
  101. ## Available Tools
  102. ### 1. search_compounds
  103. Search the ChEMBL database for compounds by name, synonym, or identifier.
  104. **Parameters:**
  105. - `query` (required): Search query (compound name, synonym, or identifier)
  106. - `limit` (optional): Number of results to return (1-1000, default: 25)
  107. - `offset` (optional): Number of results to skip (default: 0)
  108. **Example:**
  109. ```javascript
  110. {
  111. "query": "aspirin",
  112. "limit": 10
  113. }
  114. ```
  115. ### 2. get_compound_info
  116. Get detailed information for a specific compound by ChEMBL ID.
  117. **Parameters:**
  118. - `chembl_id` (required): ChEMBL compound ID (e.g., CHEMBL25)
  119. **Example:**
  120. ```javascript
  121. {
  122. "chembl_id": "CHEMBL25"
  123. }
  124. ```
  125. ### 3. search_targets
  126. Search for biological targets by name or type.
  127. **Parameters:**
  128. - `query` (required): Target name or search query
  129. - `target_type` (optional): Target type filter (e.g., SINGLE PROTEIN, PROTEIN COMPLEX)
  130. - `organism` (optional): Organism filter
  131. - `limit` (optional): Number of results to return (1-1000, default: 25)
  132. **Example:**
  133. ```javascript
  134. {
  135. "query": "dopamine receptor",
  136. "organism": "Homo sapiens",
  137. "limit": 5
  138. }
  139. ```
  140. ### 4. search_activities
  141. Search bioactivity measurements and assay results.
  142. **Parameters:**
  143. - `target_chembl_id` (optional): ChEMBL target ID filter
  144. - `assay_chembl_id` (optional): ChEMBL assay ID filter
  145. - `molecule_chembl_id` (optional): ChEMBL compound ID filter
  146. - `activity_type` (optional): Activity type (e.g., IC50, Ki, EC50)
  147. - `limit` (optional): Number of results to return (1-1000, default: 25)
  148. **Example:**
  149. ```javascript
  150. {
  151. "target_chembl_id": "CHEMBL2095173",
  152. "activity_type": "IC50",
  153. "limit": 50
  154. }
  155. ```
  156. ### 5. batch_compound_lookup
  157. Process multiple ChEMBL IDs efficiently.
  158. **Parameters:**
  159. - `chembl_ids` (required): Array of ChEMBL compound IDs (1-50)
  160. **Example:**
  161. ```javascript
  162. {
  163. "chembl_ids": ["CHEMBL25", "CHEMBL59", "CHEMBL1642"]
  164. }
  165. ```
  166. ## Resource Templates
  167. The server provides direct access to ChEMBL data through URI templates:
  168. ### 1. Compound Information
  169. - **URI**: `chembl://compound/{chembl_id}`
  170. - **Description**: Complete compound information for a ChEMBL ID
  171. - **Example**: `chembl://compound/CHEMBL25`
  172. ### 2. Target Information
  173. - **URI**: `chembl://target/{chembl_id}`
  174. - **Description**: Complete target information for a ChEMBL target ID
  175. - **Example**: `chembl://target/CHEMBL2095173`
  176. ### 3. Assay Information
  177. - **URI**: `chembl://assay/{chembl_id}`
  178. - **Description**: Complete assay information for a ChEMBL assay ID
  179. - **Example**: `chembl://assay/CHEMBL1217643`
  180. ### 4. Activity Information
  181. - **URI**: `chembl://activity/{activity_id}`
  182. - **Description**: Bioactivity measurement data for an activity ID
  183. - **Example**: `chembl://activity/12345678`
  184. ### 5. Search Results
  185. - **URI**: `chembl://search/{query}`
  186. - **Description**: Search results for compounds matching the query
  187. - **Example**: `chembl://search/aspirin`
  188. ## Examples
  189. ### Basic Compound Search
  190. Search for aspirin-related compounds:
  191. ```javascript
  192. // Tool call
  193. {
  194. "tool": "search_compounds",
  195. "arguments": {
  196. "query": "aspirin",
  197. "limit": 5
  198. }
  199. }
  200. ```
  201. ### Get Detailed Compound Information
  202. Retrieve comprehensive information about aspirin:
  203. ```javascript
  204. // Tool call
  205. {
  206. "tool": "get_compound_info",
  207. "arguments": {
  208. "chembl_id": "CHEMBL25"
  209. }
  210. }
  211. ```
  212. ### Target-based Search
  213. Find compounds tested against dopamine receptors:
  214. ```javascript
  215. // Tool call
  216. {
  217. "tool": "search_targets",
  218. "arguments": {
  219. "query": "dopamine receptor D2",
  220. "organism": "Homo sapiens"
  221. }
  222. }
  223. ```
  224. ### Bioactivity Analysis
  225. Search for IC50 data against a specific target:
  226. ```javascript
  227. // Tool call
  228. {
  229. "tool": "search_activities",
  230. "arguments": {
  231. "target_chembl_id": "CHEMBL2095173",
  232. "activity_type": "IC50",
  233. "limit": 100
  234. }
  235. }
  236. ```
  237. ### Batch Processing
  238. Process multiple compounds efficiently:
  239. ```javascript
  240. // Tool call
  241. {
  242. "tool": "batch_compound_lookup",
  243. "arguments": {
  244. "chembl_ids": ["CHEMBL25", "CHEMBL59", "CHEMBL1642", "CHEMBL1201585"]
  245. }
  246. }
  247. ```
  248. ## API Integration
  249. This server integrates with the ChEMBL REST API for programmatic access to chemical data. For more information about ChEMBL:
  250. - **ChEMBL Website**: https://www.ebi.ac.uk/chembl/
  251. - **API Documentation**: https://chembl.gitbook.io/chembl-interface-documentation/web-services
  252. - **REST API Guide**: https://www.ebi.ac.uk/chembl/api/data/docs
  253. All API requests include:
  254. - **User-Agent**: `ChEMBL-MCP-Server/1.0.0`
  255. - **Timeout**: 30 seconds
  256. - **Base URL**: `https://www.ebi.ac.uk/chembl/api/data`
  257. ## Error Handling
  258. The server includes comprehensive error handling:
  259. - **Input Validation**: All parameters are validated using type guards
  260. - **API Errors**: Network and API errors are caught and returned with descriptive messages
  261. - **Timeout Handling**: Requests timeout after 30 seconds
  262. - **Graceful Degradation**: Partial failures are handled appropriately
  263. ## Development
  264. ### Build the Project
  265. ```bash
  266. npm run build
  267. ```
  268. ### Development Mode
  269. Run TypeScript compiler in watch mode:
  270. ```bash
  271. npm run dev
  272. ```
  273. ### Project Structure
  274. ```
  275. chembl-server/
  276. ├── src/
  277. │ └── index.ts # Main server implementation
  278. ├── build/ # Compiled JavaScript output
  279. ├── package.json # Node.js dependencies and scripts
  280. ├── tsconfig.json # TypeScript configuration
  281. └── README.md # This file
  282. ```
  283. ## Dependencies
  284. - **@modelcontextprotocol/sdk**: Core MCP SDK for server implementation
  285. - **axios**: HTTP client for ChEMBL API requests
  286. - **typescript**: TypeScript compiler for development
  287. ## License
  288. MIT License
  289. ## Contributing
  290. 1. Fork the repository
  291. 2. Create a feature branch
  292. 3. Make your changes
  293. 4. Add tests if applicable
  294. 5. Submit a pull request
  295. ## Support
  296. For issues and questions:
  297. 1. Check the [ChEMBL API documentation](https://chembl.gitbook.io/chembl-interface-documentation/web-services)
  298. 2. Review the [Model Context Protocol specification](https://modelcontextprotocol.io/)
  299. 3. Open an issue on the repository
  300. ## About Augmented Nature
  301. This comprehensive ChEMBL MCP Server is developed by **[Augmented Nature](https://augmentednature.ai)**, a leading innovator in AI-powered bioinformatics and computational chemistry solutions. Augmented Nature specializes in creating advanced tools that bridge the gap between artificial intelligence and chemical research, enabling researchers to unlock deeper insights from chemical and biological data.
  302. ## Complete Tool Reference
  303. ### **Core Chemical Search & Retrieval Tools**
  304. 1. `search_compounds` - Search ChEMBL database by name, synonym, or identifier
  305. 2. `get_compound_info` - Get detailed compound information by ChEMBL ID
  306. 3. `search_by_inchi` - Find compounds by InChI key or InChI string
  307. 4. `get_compound_structure` - Retrieve chemical structures in various formats
  308. 5. `search_similar_compounds` - Find chemically similar compounds using Tanimoto similarity
  309. ### **Target Analysis & Drug Discovery Tools**
  310. 6. `search_targets` - Search for biological targets by name or type
  311. 7. `get_target_info` - Get detailed target information by ChEMBL target ID
  312. 8. `get_target_compounds` - Get compounds tested against specific targets
  313. 9. `search_by_uniprot` - Find ChEMBL targets by UniProt accession
  314. 10. `get_target_pathways` - Get biological pathways associated with targets
  315. ### **Bioactivity & Assay Data Tools**
  316. 11. `search_activities` - Search bioactivity measurements and assay results
  317. 12. `get_assay_info` - Get detailed assay information by ChEMBL assay ID
  318. 13. `search_by_activity_type` - Find bioactivity data by activity type and value range
  319. 14. `get_dose_response` - Get dose-response data and activity profiles
  320. 15. `compare_activities` - Compare bioactivity data across multiple compounds
  321. ### **Drug Development & Clinical Data Tools**
  322. 16. `search_drugs` - Search for approved drugs and clinical candidates
  323. 17. `get_drug_info` - Get drug development status and clinical trial information
  324. 18. `search_drug_indications` - Search for therapeutic indications and disease areas
  325. 19. `get_mechanism_of_action` - Get mechanism of action and target interaction data
  326. ### **Chemical Property Analysis Tools**
  327. 20. `analyze_admet_properties` - Analyze ADMET properties
  328. 21. `calculate_descriptors` - Calculate molecular descriptors and physicochemical properties
  329. 22. `predict_solubility` - Predict aqueous solubility and permeability properties
  330. 23. `assess_drug_likeness` - Assess drug-likeness using Lipinski Rule of Five
  331. ### **Advanced Search & Cross-Reference Tools**
  332. 24. `substructure_search` - Find compounds containing specific substructures
  333. 25. `batch_compound_lookup` - Process multiple ChEMBL IDs efficiently
  334. 26. `get_external_references` - Get links to external databases
  335. 27. `advanced_search` - Complex queries with multiple chemical and biological filters
  336. ## Changelog
  337. ### v1.0.0 - Initial Release
  338. - **Comprehensive Chemical Intelligence**: 27 specialized tools for drug discovery
  339. - **Core Functionality**: Compound search, target analysis, bioactivity data
  340. - **Advanced Features**: Similarity search, batch processing, cross-references
  341. - **Resource Templates**: Direct URI-based access to ChEMBL data
  342. - **Docker Support**: Containerized deployment with security best practices
  343. - **Professional Documentation**: Complete tool reference and examples
  344. - **Developed by Augmented Nature**: Professional chemical informatics platform
  345. ## Citation
  346. If you use this project in your research or publications, please cite it as follows:
  347. ```bibtex @misc{chemblmcp2025,
  348. author = {Moudather Chelbi},
  349. title = {ChEMBL MCP Server},
  350. year = {2025},
  351. howpublished = {https://github.com/Augmented-Nature/ChEMBL-MCP-Server},
  352. note = {Accessed: 2025-06-29}

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.