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

# 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:

{
  "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.