PubChem-MCP

An MCP (Model Context Protocol) server for accessing PubChem data. This server provides tools for querying the PubChem database for compounds, substances, bioassays, and related information.

Features

• Search for compounds by name, structure, or identifier
• Retrieve detailed information about compounds and substances
• Access bioassay data and molecular properties
• Query chemical classifications and cross-references
• Compatible with any MCP client, including Claude for Desktop

Installation

Option 1: From GitHub

# Clone the repository
git clone https://github.com/BioContext/PubChem-MCP.git
cd PubChem-MCP

# Create a virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate

# Install dependencies
pip install -r requirements.txt

Option 2: Using pip (Once published)

pip install pubchem-mcp

Usage

Running as a standalone server

# From source
python -m mcp_server

# If installed via pip
pubchem-mcp

Using with Claude for Desktop

1. Install Claude for Desktop
2. Configure Claude for Desktop to use this server by editing ~/Library/Application Support/Claude/claude_desktop_config.json (macOS/Linux) or %AppData%\\Claude\\claude_desktop_config.json (Windows):

{
    "mcpServers": {
        "pubchem": {
            "command": "python",
            "args": [
                "-m",
                "mcp_server"
            ]
        }
    }
}

3. Restart Claude for Desktop
4. You can now use the PubChem tools in Claude

Example queries for Claude

• "Find information about aspirin in PubChem"
• "What are the properties of compound CID 2244?"
• "Show me the structure of paracetamol"

Available Tools

• search_compound: Search for compounds by name or identifier
• get_compound_details: Get detailed information about a compound
• get_compound_properties: Get physical and chemical properties of a compound
• search_bioassay: Search for bioassays
• get_substance_details: Get detailed information about a substance
• And more...

Development

# Clone the repository
git clone https://github.com/BioContext/PubChem-MCP.git
cd PubChem-MCP

# Create a virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

License

MIT License