Content
[](https://mseep.ai/app/phelanshao-pubchem-mcp-server)
# PubChem MCP Server
A Model Context Protocol (MCP) server for retrieving chemical compound data from PubChem database.
## Overview
PubChem MCP Server is a Python implementation of an MCP server that allows AI models to query chemical compound information from the PubChem database. It provides easy access to compound properties, 2D structures, and 3D molecular coordinates through a standard MCP interface.
## Features
- Query compounds by name or PubChem CID
- Retrieve comprehensive compound data including:
- IUPAC name
- Molecular formula
- Molecular weight
- SMILES notation
- InChI and InChIKey
- Support for multiple output formats:
- JSON (default)
- CSV
- XYZ (3D structure)
- Built-in caching system to improve performance
- Automatic retry mechanism for API reliability
- Fallback 3D structure generation if PubChem 3D is unavailable
## Requirements
- Python 3.8+
- Requests library
- RDKit (optional, for enhanced 3D structure handling)
## Installation
### From Source
```bash
# Clone the repository
git clone https://github.com/yourusername/pubchem-mcp-server.git
cd pubchem-mcp-server/python_version
# Install the package
pip install -e .
# For enhanced 3D structure handling, install with RDKit
pip install -e ".[rdkit]"
```
## MCP Configuration
To use the server with Claude or other MCP-capable AI models, add the following to your MCP configuration file:
```json
{
"mcpServers": {
"pubchem": {
"command": "python3",
"args": ["/path/to/pubchem-mcp-server/python_version/mcp_server.py"],
"env": {
"PYTHONUNBUFFERED": "1"
},
"disabled": false,
"autoApprove": [
"get_pubchem_data",
"download_structure"
]
}
}
}
```
## Available Tools
### get_pubchem_data
Retrieves chemical compound structure and property data.
Parameters:
- `query` (required): Compound name or PubChem CID
- `format` (optional): Output format - "JSON" (default), "CSV", or "XYZ"
- `include_3d` (optional): Whether to include 3D structure (only valid when format is "XYZ")
Example use:
```
<use_mcp_tool>
<server_name>pubchem</server_name>
<tool_name>get_pubchem_data</tool_name>
<arguments>
{
"query": "aspirin",
"format": "JSON"
}
</arguments>
</use_mcp_tool>
```
### download_structure
Downloads structure files for a compound.
Parameters:
- `cid` (required): PubChem CID
- `format` (optional): File format - "sdf" (default), "mol", or "smi"
- `filename` (optional): Custom filename for the downloaded structure
Example use:
```
<use_mcp_tool>
<server_name>pubchem</server_name>
<tool_name>download_structure</tool_name>
<arguments>
{
"cid": "2244",
"format": "sdf"
}
</arguments>
</use_mcp_tool>
```
## Project Structure
```
pubchem-mcp-server/
├── python_version/ # Python implementation
│ ├── mcp_server.py # Main MCP server script
│ ├── setup.py # Package installation script
│ ├── pubchem_mcp_server/ # Core package
│ │ ├── __init__.py
│ │ ├── pubchem_api.py # PubChem API interaction
│ │ ├── xyz_utils.py # 3D structure and XYZ format utilities
│ │ ├── server.py # MCP server implementation
│ │ ├── cli.py # Command-line interface
│ │ └── async_processor.py # Asynchronous request handling
└── LICENSE
```
## Caching
The server uses a caching mechanism to improve performance:
- API responses are cached in memory
- 3D structure data is cached in `~/.pubchem-mcp/cache/`
## License
This project is licensed under the MIT License - see the LICENSE file for details.
Connection Info
You Might Also Like
markitdown
Python tool for converting files and office documents to Markdown.
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.
Fetch
Retrieve and process content from web pages by converting HTML into markdown format.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.