mcpField
A
Arc

Arc

ローカル
hudsonkit.com開発ツール15今日更新

Arc について

Arc は、コードでアーキテクチャ図を作成するための MCP サーバーです。AI エージェントに図の検証、レイアウト、描画、比較のツールと複数の出力形式、テーマ、関連リソースを提供します。stdio または自前で起動する HTTP サービスで利用できます。

主な機能

  1. 01図の検証と診断の取得
  2. 02図の自動レイアウト
  3. 03SVG、PNG、アニメーションの描画
  4. 04HTML、ASCII、TypeScript への出力
  5. 05図の構造差分の生成

活用シーン

  1. 01コードデータからアーキテクチャ図を生成
  2. 02図を検査して対応する修正を適用
  3. 03図をドキュメントやターミナル向けに出力
  4. 042 つの図の構造を比較

MCP 対応

Arc は MCP クライアントに図の検証、レイアウト、描画、差分比較のツールと、スキーマ、スキル、ドキュメントのリソースを公開します。公開パッケージは stdio で動作し、リポジトリから Streamable HTTP サービスも起動できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"hudsonkit-arc": {
"command": "npx",
"args": [
"-y",
"@hudsonkit/arc-mcp"
]
}
}
}
起動コマンドnpx -y @hudsonkit/arc-mcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@hudsonkit/arc-mcp0.14.1

ツール

10

掲載時のツール一覧 · 3 日前に更新

パラメーター型必須説明
diagramobjectはいArc 図の JSON オブジェクトまたは JSON 文字列
severityenumいいえ重大度で返却する診断情報をフィルターします(デフォルト:すべて)error | warning | all

詳細

Arc

@hudsonkit/arc-mcp

コードとして記述するアーキテクチャ図向けの MCP サーバー。

Model Context Protocol を通じて、Arc のツールチェーン全体を AI エージェントに提供します — あらゆる MCP クライアントから、アーキテクチャ図の作成、検証、レイアウト、レンダリング、差分表示ができます。

npm version license

実行方法

インストールは不要です — サーバーは stdio 経由で実行されます。

npx -y @hudsonkit/arc-mcp
# or: bunx @hudsonkit/arc-mcp

クライアントの設定

Node.js 22 以降が必要です。アカウント、API キー、環境設定は不要です。 PNG エクスポートにはローカルの Chrome/Chromium のインストールが必要です。アニメーションのエクスポートには ffmpeg も必要です。

Claude Code:

claude mcp add --scope project arc -- npx -y @hudsonkit/arc-mcp

Devin:

devin mcp add arc -- npx -y @hudsonkit/arc-mcp

任意の MCP クライアント(JSON 設定):

{
  "mcpServers": {
    "arc": {
      "command": "npx",
      "args": ["-y", "@hudsonkit/arc-mcp"]
    }
  }
}

ツール

ツール機能
validate_diagramArcDiagramData のコード化された診断情報 — code で処理し、supportedFixes の項目を適用して再検証します
auto_layout図全体、または最小限の入力(nodeData + connectors + connectorStyles)を自動レイアウトします
diff_diagram構造化された DiagramDelta — 差分をレンダリングするには、<ArcDiagram data={head} delta={delta} /> に渡します
render_svg決定的な SVG エクスポート — 11 種類のテーマ、ライト/ダークに対応します。作成したフローは SMIL でアニメーション化するか、flowTime の時点でサンプリングできます
render_pngローカルの Chrome/Chromium バイナリを使った PNG ラスタライズ(上書きするには ARC_CHROME、無効にするには ARC_CHROME=none を指定)。flowTime の時点でサンプリングします
render_animationChrome のフレームと ffmpeg を使って、output パスにフローの GIF/MP4 アニメーションを出力します(上書きするには ARC_FFMPEG を指定)
render_htmlReact コンポーネントのスニペット、iframe 埋め込み、またはスタンドアロン HTML ページ
render_asciiターミナルやドキュメント向けの Unicode/ASCII ボックスアート描画
diagram_to_typescript型付きの ArcDiagramData TypeScript モジュールを出力します
editor_handoffArc スタジオで図を開く URL を作成します

リソース

URI内容
arc://schema/diagramArcDiagramData 用に生成された draft-07 JSON Schema
arc://skill/diagramsエージェント向け Arc 図生成スキル
arc://docs/llmLLM 向けの簡潔なブリーフィング

HTTP 経由でのセルフホスト

公開済みのバイナリは stdio 経由で実行されます。ローカルクライアントにはこれだけで十分です。 ほかのマシンのクライアントに Arc を提供するには、リポジトリのチェックアウトから Streamable HTTP サーバーを実行します。

git clone https://github.com/hudsonkit/arc && cd arc
bun install
ARC_MCP_HOST=127.0.0.1 ARC_MCP_PORT=5190 bun run mcp:http
# MCP endpoint: http://127.0.0.1:5190/mcp · health: /health
変数デフォルト用途
ARC_MCP_PORT5190リッスンするポート
ARC_MCP_HOST0.0.0.0バインドするインターフェース。独自の認証の背後にない場合は、127.0.0.1 を使用してください
ARC_EDITOR_URLhttp://localhost:5188editor_handoff のリンク先となるスタジオのベース URL

Arc は公開 MCP エンドポイントを提供していません。ホスト型のエンドポイントが必要な場合は、 github.com/hudsonkit/arc で issue を作成してください。

MCP Registry

Arc のレジストリ ID は io.github.hudsonkit/arc です。インストールメタデータは server.json にあり、npm パッケージでも同じ mcpName を宣言しているため、レジストリで所有権を検証できます。

メンテナーは、MCP のみのパッチリリースにはパッケージスコープ mcp を指定して GitHub Actions ワークフロー Publish to npm を実行できます。協調リリースの場合は all を指定します。このワークフローはビルド前に両方のバージョンを設定し、パッケージ化したサーバーを検証して npm に公開した後、 GitHub OIDC を使ってレジストリメタデータを公開します。ドライランでは、公開せずに検証とパッケージ化を行います。 GitHub の選定 MCP カタログに掲載するには、公式 MCP Registry への公開後に 初回オンボーディング が必要です。

関連パッケージ

  • @hudsonkit/arc — React レンダラー、ビジュアルスタジオ、arc CLI、ASCII レンダラー
  • @hudsonkit/arc-viewer — ネイティブの Mermaid シーケンス図と Mermaid インポート
  • @hudsonkit/arc-iso — バニラ JS とブラウザー向けのアイソメトリックレンダラー

スタジオとドキュメント:hudsonkit.com/arc · ソース:github.com/hudsonkit/arc

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。