JsonUI 项目管理 MCP 服务器

jui-tools MCP Server

JsonUI プロジェクト管理用 MCP サーバー。jui + jsonui-doc CLI のラッパーとコンポーネント仕様参照を提供。

AI agent が CLI 構文を知らなくても、MCP ツール経由で JsonUI の全操作を実行可能。

Install

git clone git@github.com:Tai-Kimura/jsonui-mcp-server.git /tmp/jsonui-mcp-installer
bash /tmp/jsonui-mcp-installer/install.sh
rm -rf /tmp/jsonui-mcp-installer

インストール後、~/.claude.json に MCP サーバーが登録される。

プロジェクトディレクトリの設定

環境変数でデフォルトのプロジェクトディレクトリを設定可能:

{
  "mcpServers": {
    "jui-tools": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "JUI_PROJECT_DIR": "/path/to/your/project"
      }
    }
  }
}

各ツールの project_dir パラメータで上書きも可能。

Update

bash ~/.jsonui-mcp-server/install.sh

Uninstall

bash ~/.jsonui-mcp-server/uninstall.sh

Available Tools (59)

Group A: コンポーネント仕様参照 (9)

Group B: プロジェクトコンテキスト (7)

Group C: jui CLI (8)

Group D: jsonui-doc CLI (9)

Group E: API モデル連携 (3)

Group F: jsonui-test CLI (10)

jsonui-test mock serve（常駐 HTTP + run-target 実行）は RCE 面のため MCP 非公開（CLI 直叩き限定）。

Group G: jui viz (7)

Claude Code と Codex（ローカルモデルを含む）の接続済みセッションを見るローカルのビューア（jui viz）。どれもホームフォルダで走り、JUI_PROJECT_DIR は使わない。

viz_send_message は新しい通ごとに一意の message_id（ASCII英数字・_・-、8〜100文字）を渡す。同じ要求を再確認するときはIDと本文を維持し、到達未確認の通を新しいIDで再送しない。sentは受信経路の受付で、モデルの既読ではない。両側の「トーク」に履歴が残る。viz自体の導入/再起動とは別に、新ツールを認識するにはMCPクライアントの再接続が必要。

フックと中継の導入（jui viz hooks install / jui viz relay install）は ~/.claude/settings.json と利用者の MCP 設定を書くので MCP 非公開（CLI で行う）。jui が古いと（viz / start / --with-relay が無い）、結果の update_jui に更新の手順が出る。

Group H: サーバールーム（infra） (6)

docs/infra（モデル・flow・負荷・単価）を確かめ、下書きし、値段を付ける。どれも jsonui-doc … --json を呼び、その JSON を短くまとめて返す（jsonui-cli 2.3.15 以降）。書き方は jsonui-cli の document_tools/INFRA.md。

単価の取得（jui viz cloud-prices fetch）はネットへ出て viz のホームに書くので MCP 非公開（CLI で行う）。jsonui-doc が古くて --json の形が違うと、どのキーが無いかを名指しして失敗する。

Testing

単体テストは vitest（ESM ネイティブで本リポジトリのモジュール構成とそのまま噛み合うため採用）。

npm ci --ignore-scripts   # postinstall の snapshot fetch をスキップ（CI と同じ手順）
npm test                  # 全テスト実行
npm run test:watch        # watch モード

テストは完全に自己完結:

• ネットワーク・実 jui / jsonui-doc CLI・実プロジェクトには一切依存しない（child_process はモック、プロジェクトは tmp dir の fixture）
• ~/.jsonui-cli/ / $JSONUI_CLI_PATH / $JUI_PROJECT_DIR はテスト内で差し替え（tests/setup.ts）
• bundled snapshot（data/*.json）の妥当性テストはコミット済みの実データに対して走る。CI が npm ci --ignore-scripts を使うのはこのため（postinstall がリモート最新で data/ を上書きするとコミット対象のデータを検証できなくなる）
• scripts/fetch-definitions.js のネットワーク挙動はテスト対象外

CI は .github/workflows/test.yml（Node 20 / 22 matrix、main への push と PR で実行）。

Prerequisites

• Node.js 18+
• jui CLI (pip install jui-tools)
• jsonui-doc CLI (pip install jsonui-doc-cli)