hepdata-mcp

# HEPData MCP This is an MCP server for discovering HEPData records, listing tables, fetching table data, and exposing HEPData export links. This is an early MVP implementation, focused on read-only access to public HEPData content. Local stdio is the default and recommended mode. HTTP support exists for local testing and hardened central deployments, but remote HTTP is also supported for multiple clients support. ## Run From PyPI HEPData MCP is published on PyPI as [`hepdata-mcp`](https://pypi.org/project/hepdata-mcp/). The easiest way to run it is with `uvx`: ```bash uvx hepdata-mcp ``` If you want to avoid package resolution during MCP client startup, install the tool once: ```bash uv tool install hepdata-mcp hepdata-mcp ``` Upgrade that installed tool with `uv tool upgrade hepdata-mcp`. For MCP client configs in this mode, use `hepdata-mcp` as the command with no arguments. ## Install From Source For development, install this checkout in editable mode: ```bash git clone https://github.com/HEPData/hepdata-mcp ~/.local/uv/hepdata-mcp-src cd ~/.local/uv/hepdata-mcp-src uv sync --all-groups ``` For development checks: ```bash uv run pytest uv run ruff check . uv run ruff format --check . uv run mypy ``` ## Docker The Docker image is published on Docker Hub as [`hepdata/hepdata-mcp`](https://hub.docker.com/r/hepdata/hepdata-mcp). Pull the latest release: ```bash docker pull hepdata/hepdata-mcp:latest ``` For reproducible deployments, pin a release tag such as `hepdata/hepdata-mcp:0.1.0`. Run over stdio for clients that can launch Docker commands: ```bash docker run --rm -i hepdata/hepdata-mcp:latest ``` Example stdio client command: ```json { "mcpServers": { "hepdata": { "command": "docker", "args": ["run", "--rm", "-i", "hepdata/hepdata-mcp:latest"] } } } ``` Run local streamable HTTP: ```bash docker run --rm \ -p 127.0.0.1:8000:8000 \ -e HEPDATA_MCP_ALLOW_REMOTE_HTTP=1 \ -e HEPDATA_MCP_TRUST_PROXY_AUTH=1 \ hep…