日本語 | English

fugaku-mcp

スーパーコンピュータ「富岳」を AIエージェント（Claude Code 等）から自然言語で操作できるようにする MCP（Model Context Protocol）サーバ。富岳の公式 REST WebAPI（X.509証明書認証）をラップし、 ジョブ投入・監視・ファイル転送・状態確認をエージェントのツールとして公開する。

Claude Code に「富岳で hostname と date を出すジョブを投げて結果を見せて」と指示するだけで、 ジョブ投入 → ステータス監視 → 結果回収まで全自動で実行できる。

▶ はじめて使う方は QUICKSTART.md（5分で使い始められます）

アーキテクチャ

[AIエージェント / Claude Code]  --MCP-->  [fugaku_mcp.py]  --REST/X.509-->  富岳WebAPI  -->  富岳
       LLM=頭脳                      薄いMCPアダプタ          (R-CCS公式)         ジョブ実行

LLM本体は手元（ローカル）で動き、富岳側は計算の実行に専念する。両者は証明書付きHTTPSのAPI呼び出しでつながる。 MCPサーバを含め、このツールはすべて利用者のローカルで動作する（富岳側に常駐プロセスは置かない）。

Related MCP server: ssh-mcp

構成

公開ツール

セットアップ（要点）

python3 -m venv .venv && .venv/bin/pip install "mcp[cli]~=2.0"
openssl pkcs12 -in <account>.p12 -nodes -out <account>.pem   # cert+key 結合PEM

# 設定は証明書パスのみ必須（HOME/アカウント/グループは起動時に自動検出）
export FUGAKU_CERT=/path/to/<account>.pem
python test_client.py          # ツール一覧 + cluster_status で確認

# 新規ユーザーのオンボーディングは ↓（p12→pem・疎通確認・.mcp.json生成）
./setup_user.sh <account>.p12

詳細な手順は QUICKSTART.md、複数人運用は docs/multi-user.md を参照。

プラグインとして導入（/plugin・手編集不要）

Claude Code では marketplace 経由でも導入できます（.mcp.json の手編集が不要）:

/plugin marketplace add RIKEN-RCCS/fugaku-mcp
/plugin install fugaku@fugaku-mcp

• 導入後 /fugaku:setup で証明書を配置（.p12→.pem 変換して ~/.fugaku/fugaku.pem へ）。/reload-plugins か再起動で有効化。

• Python依存(mcp)は初回起動時に自動用意されます（plugin-run.sh が venv を作成）。Python 3.10+ が必要。

• 証明書のみ各自で用意（HPCI/R-CCS 発行）。

前提

• 富岳のアカウントと X.509 クライアント証明書（HPCI/R-CCS のポータルで発行）

• Python 3.10+（3.14で mcp 導入に難があれば 3.12 推奨）、Claude Code

• 富岳WebAPIへ到達できるネットワーク（VPN不要）

セキュリティ

• 証明書（*.pem / *.p12）や秘密鍵・トークンは絶対にコミットしない（.gitignore で除外済み）。

• 安全策ポリシー（コマンド許可/拒否・パス制限・資源上限・監査ログ）を環境変数で制御。詳細は docs/security.md。

• 操作は富岳側で利用者のアカウント権限に閉じる（OSレベルで分離）。

• 注意: AIアシスタントが読み取った内容（ファイル本文・ジョブ出力）は応答生成のためAIモデルに送られる。機微データの取り扱いに注意（docs/faq.md）。

ライセンス

MIT License