cds-mcp

A Model Context Protocol (MCP) server for integrating with CERN Document Server (CDS), built on the Invenio digital library framework.

• Search CDS documents with filters for experiments, document types, and date ranges
• Get detailed document information including full abstracts, authors, and metadata
• Access document files with download URLs and file metadata
• Browse experiments and document types for better search filtering

Requires Python 3.10+.

No installation needed, just use uvx to run directly:

uvx cds-mcp

pip install cds-mcp

git clone https://github.com/MohamedElashri/cds-mcp
cd cds-mcp
uv sync

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cds": {
      "command": "uvx",
      "args": ["cds-mcp"],
      "env": {
        "CERN_CLIENT_ID": "your-client-id",
        "CERN_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

For public access only, omit the authentication environment variables:

{
  "mcpServers": {
    "cds": {
      "command": "uvx",
      "args": ["cds-mcp"]
    }
  }
}

Note for macOS users: If you see an error about uvx not being found, you may need to provide the absolute path. Claude Desktop does not support ~ or $HOME expansion.

1. Run which uvx in your terminal to find the path (e.g., /Users/yourusername/.local/bin/uvx).
2. Use that absolute path in the command field:

"command": "/Users/yourusername/.local/bin/uvx"

Project-specific (default) — installs in the current directory's configuration:

claude mcp add cds-mcp -- uvx cds-mcp

Global — installs for your user account (works in all projects):

claude mcp add --scope user cds-mcp -- uvx cds-mcp

To include authentication, add the CERN