ami-mcp v0.2.1

Ein MCP-Server, der das ATLAS AMI (ATLAS Metadata Interface) und die PMG-Querschnittsdatenbank umschließt und sie als Werkzeuge für LLMs bereitstellt. Entwickelt für ATLAS-Physiker, die MC-Samples finden, Querschnitte und Filtereffizienzen nachschlagen sowie PMG-Hashtag-Klassifizierungen validieren müssen.

Was es tut

ami-mcp ermöglicht es Claude (oder jedem MCP-kompatiblen LLM), ATLAS-Metadaten direkt abzufragen:

• Samples finden: Suche nach MC-Datensätzen anhand von PMG-Hashtag-Klassifizierungen (WeakBoson/Vjets/Baseline), nach Namensmustern oder durch beliebige AMI-Abfragen

• Metadaten nachschlagen: Abruf von Querschnitten, Filtereffizienzen, k-Faktoren, Datensatz-Provenienz und AMI-Processing-Tag-Informationen

• Querschnittsdatenbank abfragen: Nachschlagen von DSID-Einträgen in den PMG-xsec-Datenbankdateien (PMGxsecDB_mc16.txt, etc.)

• Samples validieren: Überprüfung von Hashtag-Klassifizierungen und Vergleich von Metadaten mit der PMG-Querschnittsdatenbank

• Allgemeine Abfragen: Ausführung beliebiger AMI-Befehlszeichenfolgen, die vom LLM unter Verwendung der Ressource ami://query-language als Leitfaden formuliert wurden

Related MCP server: rucio-mcp

Installation

pip install ami-mcp

Oder mit pixi (empfohlen für ATLAS-Einrichtungen):

pixi add ami-mcp

Anforderungen

• Python 3.10 oder 3.11 (pyAMI erfordert <3.12)

• Ein gültiger VOMS-Proxy (voms-proxy-init -voms atlas)

• Grid-CA-Zertifikate (verfügbar auf CVMFS an ATLAS-Standorten)

Schnellstart

1. Authentifizierung einrichten

voms-proxy-init -voms atlas

Bei Installation via pip (nicht pixi/conda-forge), setzen Sie zusätzlich X509_CERT_DIR. An CVMFS-basierten Einrichtungen (z. B. UChicago Analysis Facility, CERN lxplus):

export X509_CERT_DIR=/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase/etc/grid-security-emi/certificates

Bei der Installation via pixi oder conda-forge ist ca-policy-lcg enthalten und setzt X509_CERT_DIR automatisch — kein zusätzlicher Schritt erforderlich.

2. Den Server testen

ami-mcp serve

Der Server spricht MCP über stdio. Konfigurieren Sie Ihren MCP-Client, um ihn zu starten.

3. Claude Code konfigurieren

Mit pixi (empfohlen — X509_CERT_DIR wird automatisch gesetzt):

{
  "mcpServers": {
    "ami": {
      "type": "stdio",
      "command": "pixi",
      "args": ["run", "ami-mcp", "serve"],
      "env": {
        "ATLAS_PMGXSEC_PATH": "/cvmfs/atlas.cern.ch/repo/sw/database/GroupData/dev/PMGTools"
      }
    }
  }
}

Mit pip (muss X509_CERT_DIR manuell setzen):

{
  "mcpServers": {
    "ami": {
      "command": "ami-mcp",
      "args": ["serve"],
      "env": {
        "X509_CERT_DIR": "/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase/etc/grid-security-emi/certificates",
        "ATLAS_PMGXSEC_PATH": "/cvmfs/atlas.cern.ch/repo/sw/database/GroupData/dev/PMGTools"
      }
    }
  }
}

4. Claude Desktop konfigurieren

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ami": {
      "command": "ami-mcp",
      "args": ["serve"],
      "env": {
        "X509_CERT_DIR": "/path/to/ca-certificates",
        "ATLAS_PMGXSEC_PATH": "/path/to/PMGTools"
      }
    }
  }
}

Verfügbare Werkzeuge

AMI-Abfragen

PMG-Hashtags

Physik-Metadaten

Querschnittsdatenbank

Validierung

Beispiel-Prompts

Sobald konfiguriert, können Sie Claude Dinge fragen wie:

• "Finde alle Baseline WeakBoson/Vjets Samples in mc21_13TeV"

• "Was sind der Querschnitt und die Filtereffizienz für DSID 700320?"

• "Schlage die Hashtag-Klassifizierung für dieses EVNT-Dataset nach"

• "Validiere diese Samples gegen die mc21-Querschnittsdatenbank"

• "Zeige mir die Provenienz-Kette für dieses DAOD-Dataset"

• "Welchem AMI-Tag e8351 entspricht das — welche Generator-Version?"