ami-mcp v0.2.1

ATLAS AMI (ATLAS Metadata Interface) とPMG断面積データベースをラップし、LLM向けのツールとして公開するMCPサーバーです。MCサンプルの検索、断面積やフィルター効率の調査、PMGハッシュタグ分類の検証が必要なATLAS物理学者向けに設計されています。

機能

ami-mcp を使用すると、Claude（またはMCP互換のLLM）がATLASメタデータを直接クエリできます：

• サンプルの検索: PMGハッシュタグ分類（WeakBoson/Vjets/Baseline）、名前パターン、または任意のAMIクエリによるMCデータセットの検索

• メタデータの取得: 断面積、フィルター効率、k-factor、データセットの来歴、AMI処理タグ情報の取得

• 断面積DBのクエリ: PMG xsecデータベースファイル（PMGxsecDB_mc16.txtなど）内のDSIDエントリの検索

• サンプルの検証: ハッシュタグ分類の確認およびPMG断面積データベースとのメタデータ比較

• 一般的なクエリ: ami://query-language リソースをガイドとして使用し、LLMが作成した任意のAMIコマンド文字列の実行

Related MCP server: rucio-mcp

インストール

pip install ami-mcp

またはpixiを使用する場合（ATLAS施設で推奨）：

pixi add ami-mcp

要件

• Python 3.10 または 3.11 (pyAMIは <3.12 が必要)

• 有効なVOMSプロキシ (voms-proxy-init -voms atlas)

• Grid CA証明書 (ATLASサイトのCVMFSで利用可能)

クイックスタート

1. 認証の設定

voms-proxy-init -voms atlas

pip経由でインストールした場合（pixi/conda-forgeではない場合）、X509_CERT_DIR も設定してください。CVMFSベースの施設（例：UChicago Analysis Facility、CERN lxplus）では以下の通りです：

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

pixiまたはconda-forge経由でインストールした場合、ca-policy-lcg が含まれており、X509_CERT_DIR が自動的に設定されるため、追加の手順は不要です。

2. サーバーのテスト

ami-mcp serve

サーバーはstdio経由でMCPと通信します。MCPクライアントを構成して起動してください。

3. Claude Codeの設定

pixiを使用する場合（推奨 — X509_CERT_DIR は自動的に設定されます）：

{
  "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"
      }
    }
  }
}

pipを使用する場合（X509_CERT_DIR を手動で設定する必要があります）：

{
  "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の設定

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %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"
      }
    }
  }
}

利用可能なツール

AMIクエリ

PMGハッシュタグ

物理メタデータ

断面積データベース

検証

プロンプト例

設定が完了すると、Claudeに以下のように尋ねることができます：

• "mc21_13TeV内のすべてのBaseline WeakBoson/Vjetsサンプルを見つけて"

• "DSID 700320の断面積とフィルター効率は？"

• "このEVNTデータセットのハッシュタグ分類を調べて"

• "mc21断面積データベースに対してこれらのサンプルを検証して"

• "このDAODデータセットの来歴チェーンを表示して"

• "AMIタグ e8351 は何に対応しているか（どのジェネレーターバージョンか）？"