Composer について
Composer はコーディングエージェント向けのビジュアルなアーキテクチャ設計ツールです。IDE からインタラクティブな図を作成・編集でき、変更はライブキャンバスに反映されます。コードベースの取り込みや図の検証にも対応します。
主な機能
- 01図の作成と選択
- 02図のグラフの読み取りと検索
- 03ノードとエッジの追加・更新
- 04API 定義とソースパスの関連付け
- 05図の検証とコードベースの取り込み
活用シーン
- 01コードベースからアーキテクチャ図を作成
- 02設計内のサービスや接続を更新
- 03図のノードをソースファイルに関連付け
- 04エンドポイント不足や孤立ノードを確認
MCP 対応
MCP サーバーはコーディングエージェントに Composer の図操作ツールを提供し、Composer API に接続します。リモート HTTP 接続と stdio に対応し、OAuth 2.1 で認可します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Composer MCP Server
AI コーディングエージェントにアーキテクチャキャンバスを提供します。
IDE から直接、ソフトウェアアーキテクチャ図を設計、可視化し、進化させましょう。
Composer は、AI コーディングエージェントが MCP(Model Context Protocol) を通じて、インタラクティブなアーキテクチャ図を作成・変更できるビジュアルシステム設計ツールです。エージェントはサービス、データベース、キュー、接続を追加するツールを利用でき、usecomposer.com ではリアルタイムに更新されるライブキャンバスを確認できます。
Your IDE <--> MCP Server (this package) <--> Composer API <--> Your Diagram
はじめに
IDE を接続する
Claude Code:
claude mcp add --transport http composer https://mcp.usecomposer.com
Cursor — プロジェクトのルートに .cursor/mcp.json を作成します。
{
"mcpServers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
初回使用時に、認証のためブラウザーが開きます。
Claude Code
claude mcp add --transport http composer https://mcp.usecomposer.com
Cursor
プロジェクトのルートに .cursor/mcp.json を作成します。
{
"mcpServers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
Codex
codex mcp add composer -- npx -y @usecomposer/mcp --stdio
VS Code (Copilot Chat)
プロジェクトのルートに .vscode/mcp.json を作成します。
{
"servers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
VS Code (Cline)
Cline サイドバー > Settings(歯車アイコン)> MCP Servers > Add Remote Server を開きます。
{
"mcpServers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
VS Code (Continue)
.continue/config.yaml に追加します。
mcpServers:
- name: composer
url: https://mcp.usecomposer.com
Windsurf
~/.codeium/windsurf/mcp_config.json に追加します。
{
"mcpServers": {
"composer": {
"serverUrl": "https://mcp.usecomposer.com"
}
}
}
注: Windsurf では
"url"の代わりに"serverUrl"を使用します。
OpenCode
プロジェクトのルートに opencode.json を作成します。
{
"mcp": {
"composer": {
"type": "remote",
"url": "https://mcp.usecomposer.com"
}
}
}
ツール
図の管理
| ツール | 説明 |
|---|---|
list_diagrams | すべての図を一覧表示します。最初に呼び出して、作業する図を確認します |
create_diagram | 新しい図を作成し、このセッションで自動的に選択します |
select_diagram | このセッションで作業する図を選択します |
rename_diagram | 現在選択されている図の名前を変更します |
注: 他のツールを使用する前に、
list_diagramsを呼び出し、続けてselect_diagram(またはcreate_diagram)を呼び出してください。
読み取り
| ツール | 説明 |
|---|---|
get_graph | アーキテクチャ図全体(すべてのノードとエッジ)を取得します |
get_node | 接続されているエッジを含め、単一のノードの詳細を取得します |
search_graph | キーワードでノードとエッジを検索します |
get_screenshot | 最後の自動保存時点の図の PNG サムネイルを取得します |
書き込み
| ツール | 説明 |
|---|---|
upsert_node | ノード(サービス、データベース、キューなど)を作成または更新します |
upsert_edge | 2 つのノード間の接続を作成または更新します |
define_api | バックエンドサービスのノードに API エンドポイントを定義します |
delete_element | 図からノードまたはエッジを削除します |
link_path | ノードをコードベース内のファイルまたはフォルダーにリンクします |
計画と検証
| ツール | 説明 |
|---|---|
verify_diagram | エンドポイントの欠落や孤立したノードなどの問題を確認します |
plan_import | 既存のコードベースをインポートするためのステップごとのワークフローです |
get_guide | ノードの種類、プロトコル、ベストプラクティスに関するリファレンスガイドです |
ノードの種類
client · frontend · backend · database · cache · queue · storage · external
エッジのプロトコル
REST · gRPC · GraphQL · WebSocket · TCP · UDP · async · event · internal
プロンプトの例
接続したら、AI エージェントに次のように尋ねてみてください。
| プロンプト | 動作 |
|---|---|
| "このコードベースを Composer にインポートして" | リポジトリをスキャンし、アーキテクチャ図を作成します |
| "Backend Architecture という名前で新しい Composer の図を作成して" | 新しい図を作成し、自動的に選択します |
| "Composer で API とデータベースの間に Redis キャッシュを追加して" | 図に新しいノードとエッジを追加します |
| "Composer の図に分析モニタリングを追加して" | 可観測性ノードと接続を追加します |
| "Composer で定義した API を更新して" | バックエンドノードのエンドポイント定義を更新します |
| "Composer の図を検証して" | エンドポイントの欠落や孤立したノードなどを確認します |
| "各 Composer ノードをソースコードにリンクして" | 図のノードをファイルパスに関連付けます |
仕組み
認証には OAuth 2.1 を使用します。ブラウザーが開き、一度限りの同意フローを完了すると接続されます。ツール呼び出しは mcp.usecomposer.com の Composer API にプロキシされます。図のデータは Composer のサーバー上に保存されます。MCP サーバー自体はステートレスです。
MCP 経由で行った変更は、リアルタイムの WebSocket 同期により、Composer キャンバスにすぐに反映されます。
開発
git clone https://github.com/olivergrabner/composer-mcp
cd composer-mcp
npm install
npm run dev # Watch mode (rebuilds on change)
npm run build # Production build
リンク
- Composer - ビジュアルなアーキテクチャキャンバス
- MCP Protocol - Model Context Protocol の仕様
- Issues - バグ報告と機能リクエスト
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。