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 MCP
Converting files and office documents to Markdown.
Filesystem
Model Context Protocol Servers
Sequential Thinking
Offers a structured approach to dynamic and reflective problem-solving,...
ZipAgent
轻量级AI Agent框架,让你5分钟构建专属智能助手。
Lightweight AI Agent framework. Build your AI...
mcp-probe
A Model Context Protocol (MCP) client library and debugging toolkit in Rust....
MuiceBot
Muice-Chatbot's Nonebot2 Implementation | Supports calling mainstream large...