samlevy3/mcp-server-demo

Interactive PubMed Central MCP Server

An intelligent PubMed Central search interface that uses the Model Context Protocol (MCP) to provide natural language interaction with PubMed's database. This server integrates with Claude Desktop and other MCP-compatible clients.

Features

• Natural language query processing
• Intelligent search refinement
• Full-text article retrieval
• Article similarity search
• Search history tracking
• Abstract and summary generation
• PMC full-text access

Installation

1. Clone the repository:

git clone <repository-url>
cd usdc

2. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On macOS/Linux

3. Install the package:

pip install -e .

Usage with Claude Desktop

1. Add the server configuration to Claude Desktop:

{
  "mcpServers": {
    "pubmed-search": {
      "command": "/path/to/venv/bin/interactive_pmc_server",
      "args": [],
      "env": {}
    }
  }
}

2. Start Claude Desktop and access the PubMed search capabilities through natural language queries:
   • "Search for recent COVID-19 vaccine efficacy studies"
   • "Find systematic reviews about machine learning in healthcare"
   • "Get the full text of PMC7745631"

Available Tools

PubMed Search Tools

• interactive_pmc_server: Main PubMed search interface with natural language processing
  • Start new searches
  • Refine existing searches
  • Get article abstracts
  • Access full-text articles
  • View search history

Simple Math Tools

• simple_server: Basic mathematical operations (for testing/development)
  • Add numbers
  • More operations coming soon

Development

1. Requirements:

   • Python 3.8 or higher
   • mcp[cli] package

2. Set up the development environment:

python -m venv venv
source venv/bin/activate  # On macOS/Linux
pip install -e .

3. Run the servers:

# Run PubMed search server
interactive_pmc_server

# Run simple math server
simple_server

Project Structure

usdc/
├── src/
│   ├── interactive_pmc_server/
│   │   └── interactive_pmc.py
│   └── simple_server/
│       └── math_server.py
├── pyproject.toml
├── README.md
└── .gitignore

License

[Your chosen license]

Contributing

[Contribution guidelines]