ArcSync

arcsync-mcp

コーディングエージェント（Claude Code、Cursor、GitHub Copilot、およびその他の MCP クライアント）に、インフラストラクチャ・アズ・コード（Terraform、AWS CDK、CloudFormation、Pulumi、Azure ARM、Serverless Framework）から解析したアーキテクチャグラフ ArcSync を提供する MCP サーバーです。

ツール：list_diagrams、get_diagram（Mermaid または JSON、およびキャンバスへのリンク）、describe_resource、get_delta、list_versions、start_parse、get_parse_status。エージェントが独自に作成する図には、validate_diagram（ローカルでのチェック）、push_diagram（図を保存し、キャンバスと Notion 埋め込み用のリンクを取得）、get_diagram_source、list_icons を使用します。

セットアップ

.mcp.json に追加します（認証情報は含まれないため、安全にコミットできます）。

{
  "mcpServers": {
    "arcsync": {
      "command": "npx",
      "args": ["-y", "arcsync-mcp"]
    }
  }
}

Claude Desktop

最新のリリースから arcsync-mcp-<version>.mcpb をダウンロードして開きます。Claude Desktop が拡張機能をインストールするため、編集する設定ファイルはありません。ブラウザー経由で接続する場合（以下を参照）は 2 つの認証情報欄を空欄のままにし、Settings の MCP 認証情報を使う場合は両方に入力します。

Node.js を使わない場合

各リリースにはスタンドアロンバイナリも含まれています。macOS または Linux では、Homebrew でインストールできます（Intel Mac では、Homebrew は独自の Node.js 上に npm パッケージをインストールします）。

brew install vanlandinghamlabs/tap/arcsync-mcp

Windows をお使いの場合、または Homebrew を使わない場合は、Releasesからお使いのプラットフォーム用のアーカイブをダウンロードし、gh attestation verify <archive> -R VanLandinghamLabs/arcsync-mcp で検証してください。その後、args を指定せずに "command": "arcsync-mcp" を使用し、以下の npx コマンドの代わりに arcsync-mcp login／logout を実行します。

このサーバーは、io.github.VanLandinghamLabs/arcsync-mcp として MCP Registry に登録されています。

接続

最初のツール呼び出しで、https://arcsync.dev/settings/mcp/connect へのリンクが返されます。リンクを開いてサインインし、Connect をクリックしてください。ArcSync が MCP 認証情報を発行し、127.0.0.1 経由でサーバーに渡します。サーバーは認証情報を ~/.config/arcsync/mcp-credential.json（モード 0600）に保存し、次回の呼び出しから使用します。ターミナルからは、npx -y arcsync-mcp login でも同じ操作ができます。npx -y arcsync-mcp logout を実行すると、保存されたファイルが削除されます。

CI または共有マシンでは、代わりに https://arcsync.dev/settings で MCP 認証情報を作成し、サーバーの環境変数として ARCSYNC_CLIENT_ID と ARCSYNC_CLIENT_SECRET を渡してください。これらは保存済みの認証情報より優先されます。

skills/ には 2 つのエージェントスキルが含まれています。arcsync-mcp は各グラフツールを呼び出すタイミングをエージェントに伝え、arcsync-diagrams はエージェント自身が図を作成、検証、送信する方法を教えます。skills CLI がサポートする Claude Code、Codex、Cursor、その他のエージェントに、両方をインストールしてください。

npx skills add VanLandinghamLabs/arcsync-mcp

スキルをインストールしてもサーバーはインストールされません。上記の手順でサーバーを追加してください。

詳しいガイド：https://arcsync.dev/docs/mcp

ソースと開発

このリポジトリは各リリース時に ArcSync モノレポからミラーされ、サーバーが使用する ArcSync コアモジュール（vendor/core/）も含まれています。リリースは来歴情報付きでこのリポジトリから npm に公開されるため、npm view arcsync-mcp --json で各バージョンをビルドしたコミットとワークフロー実行にたどることができます。Issue やプルリクエストを歓迎します。採用された変更はモノレポに反映され、次のリリースに含まれます。

npm ci
npm test
npm run build            # dist/index.js, one self-contained file
npm run eval:diagrams    # arcsync-diagrams skill evals; after build, costs model calls

ライセンス

MIT