Particle Physics

Provides access to particle physics data via MCP clients, enabling real-time searches and decay information.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "uzerone-particlephysics-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        ".",
        "python",
        "-m",
        "particlephysics_mcp_server"
      ]
    }
  }
}

You can query and retrieve particle physics data in real time using the ParticlePhysics MCP Server. It exposes particle properties and decay information to MCP clients, enabling fast searches and data retrieval for your workflows and analyses.

How to use

Start the MCP server using the provided stdio configuration, then interact with it through your MCP client to search for particles and fetch their decay modes. You can search by name or symbol to obtain key properties, and you can request all decay channels for a given particle to understand its behavior.

How to install

Prerequisites: you should have Python installed on your system and access to the MCP runtime tool you will use (uvx). Ensure you can run Python commands from the command line.

Create a working directory for the MCP server project and navigate into it.
Start the MCP server using the configuration shown below. This launches the server via the uvx runner and runs the Python module that implements the MCP server.

uvx --from . python -m particlephysics_mcp_server

Additional notes

Configuration for the MCP server is provided in the following snippet. It specifies the runtime command and arguments needed to start the server.

{
  "mcpServers": {
    "particlephysics": {
      "command": "uvx",
      "args": ["--from", ".", "python", "-m", "particlephysics_mcp_server"]
    }
  }
}

Local testing and maintenance

To inspect and test the MCP server locally, use the provided scripts and test suites.

Restart the inspector for MCP testing.

./restart_mcp_inspector.sh

Run end-to-end tests with Playwright.

uvx pytest tests/test_e2e_playwright.py

Maintainers

This MCP server is maintained by the project’s core contributors.

License

MIT License - see the license file for details.

Available tools

search_particle

Returns key properties inline for a given particle by name or symbol.

list_decays

Returns all decay modes for a specified particle by name or symbol.