inspirehep-mcp

# InspireHEP MCP Server An [MCP](https://modelcontextprotocol.io/) server that integrates [InspireHEP](https://inspirehep.net/) high-energy physics literature with LLMs. Search papers, explore citations, retrieve author metrics, and generate formatted references. ## Installation ```bash # Using pip pip install inspirehep-mcp # Or run directly with uvx (no install needed) uvx inspirehep-mcp ``` <details> <summary>Install from source</summary> ```bash git clone https://github.com/MohamedElashri/inspirehep-mcp.git cd inspirehep-mcp uv sync uv run inspirehep-mcp ``` </details> ## Remote endpoint deployment The installed command remains a stdio server by default, so existing desktop configurations continue to work. To run it natively as a remote MCP endpoint, select the Streamable HTTP transport: ```bash INSPIREHEP_ALLOWED_HOSTS="mcp.example.org" \ INSPIREHEP_HTTP_RATE_LIMIT=60 \ inspirehep-mcp --transport streamable-http --host 0.0.0.0 --port 8000 ``` The MCP endpoint is `http://localhost:8000/mcp` and the unauthenticated health probe is `http://localhost:8000/health`. `PORT` is also honored when a hosting platform injects it. Put the service behind HTTPS for internet deployment. ### Docker Release tags publish a container to the GitHub Container Registry. The image uses Streamable HTTP by default: ```bash docker run --rm -p 8000:8000 \ ghcr.io/mohamedelashri/inspirehep-mcp:latest ``` For a public hostname, add it to the host allowlist: ```bash docker run --rm -p 8000:8000 \ -e INSPIREHEP_ALLOWED_HOSTS="mcp.example.org" \ -e INSPIREHEP_HTTP_RATE_LIMIT=60 \ ghcr.io/mohamedelashri/inspirehep-mcp:latest ``` The image runs as a non-root user, has a built-in health check, and uses stateless JSON responses so replicas do not need shared MCP session state. ### Docker Compose The included [`docker-compose.yml`](docker-compose.yml) can build the current checkout or run the published image: ```bash # Local deployment docker compose up --build -d #…