Composer

io.github.OliverGrabner由 GitHub 帳號 OliverGrabner 發布v0.1.7更新於 Oct 24, 2026

Give your AI coding agent an architecture canvas to design and evolve diagrams.

已驗證STDIO僅桌面開發者工具媒體與設計

概覽

AI 產生的概覽

Composer 為 AI 程式助理提供視覺化架構畫布，用來建立、編輯與檢查軟體架構圖。

可以做什麼
列出、建立、選取並重新命名工作階段中的架構圖，畫布會隨助理操作即時更新。讀取完整架構圖、檢視單一節點及其連線、依關鍵字搜尋節點與邊，並取得最近自動儲存的 PNG 縮圖。建立或更新服務、資料庫、快取、佇列、儲存等節點，以及它們之間帶 REST、gRPC、非同步等協定的連線。在後端節點上定義 API 端點，刪除節點或邊，並把圖中節點連結到程式碼庫中的檔案或資料夾。檢查架構圖是否缺少端點或有孤立節點，並依引導流程匯入現有程式碼庫。
適用情境
適合讓助理把程式碼庫或設計討論整理成可持續維護的架構圖，或在系統演進時同步更新圖中的服務、端點與連線關係。
執行需求
以本機 npm 套件（npx @usecomposer/mcp）透過 stdio 執行，也可作為遠端 HTTP 端點連線。需要 Composer 帳號，首次使用須在瀏覽器完成 OAuth 2.1 授權，並需能存取 Composer API 的網路。
安裝前請注意
架構圖資料存放在 Composer 的伺服器上，工具呼叫會轉送到 Composer API，因此架構細節會離開本機。寫入類工具會建立、更新與刪除節點和邊，變更會立即顯示在共用畫布上。將節點連結到程式碼庫路徑會把檔案與資料夾名稱暴露給該服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Composer，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[Composer demo]

[Composer logo] Composer MCP Server

Give your AI coding agent an architecture canvas.
Design, visualize, and evolve software architecture diagrams - right from your IDE.

[npm version] [MIT License] [MCP Compatible]

Composer is a visual system design tool that lets AI coding agents create and modify interactive architecture diagrams through MCP (Model Context Protocol). Your agent gets tools to add services, databases, queues, and connections, and you get a live canvas at usecomposer.com that updates in real-time.

Your IDE  <-->  MCP Server (this package)  <-->  Composer API  <-->  Your Diagram

Getting Started

Connect your IDE

Claude Code:

bash
claude mcp add --transport http composer https://mcp.usecomposer.com

Cursor — create .cursor/mcp.json in your project root:

json
{  "mcpServers": {    "composer": {      "type": "http",      "url": "https://mcp.usecomposer.com"    }  }}

Your browser will open for authorization on first use.

Claude Code
bash
claude mcp add --transport http composer https://mcp.usecomposer.com
Cursor

Create .cursor/mcp.json in your project root:

json
{  "mcpServers": {    "composer": {      "type": "http",      "url": "https://mcp.usecomposer.com"    }  }}
Codex
bash
codex mcp add composer -- npx -y @usecomposer/mcp --stdio
VS Code (Copilot Chat)

Create .vscode/mcp.json in your project root:

json
{  "servers": {    "composer": {      "type": "http",      "url": "https://mcp.usecomposer.com"    }  }}
VS Code (Cline)

Open Cline sidebar > Settings (gear icon) > MCP Servers > Add Remote Server:

json
{  "mcpServers": {    "composer": {      "type": "http",      "url": "https://mcp.usecomposer.com"    }  }}
VS Code (Continue)

Add to .continue/config.yaml:

yaml
mcpServers:  - name: composer    url: https://mcp.usecomposer.com
Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "composer": {      "serverUrl": "https://mcp.usecomposer.com"    }  }}

Note: Windsurf uses "serverUrl" instead of "url".

OpenCode

Create opencode.json in your project root:

json
{  "mcp": {    "composer": {      "type": "remote",      "url": "https://mcp.usecomposer.com"    }  }}

Tools

Diagram Management

ToolDescription
list_diagramsList all your diagrams. Call this first to find which diagram to work on
create_diagramCreate a new diagram and auto-select it for this session
select_diagramSelect which diagram to work on for this session
rename_diagramRename the currently selected diagram

Note: Call list_diagrams then select_diagram (or create_diagram) before using other tools.

Read

ToolDescription
get_graphGet the full architecture diagram - all nodes and edges
get_nodeGet details for a single node including connected edges
search_graphSearch nodes and edges by keyword
get_screenshotGet a PNG thumbnail of the diagram from the last auto-save

Write

ToolDescription
upsert_nodeCreate or update a node (service, database, queue, etc.)
upsert_edgeCreate or update a connection between two nodes
define_apiDefine API endpoints on a backend service node
delete_elementDelete a node or edge from the diagram
link_pathLink a node to a file or folder in your codebase

Plan & Verify

ToolDescription
verify_diagramCheck for issues like missing endpoints or orphaned nodes
plan_importStep-by-step workflow for importing an existing codebase
get_guideReference guide for node types, protocols, and best practices

Node Types

client · frontend · backend · database · cache · queue · storage · external

Edge Protocols

REST · gRPC · GraphQL · WebSocket · TCP · UDP · async · event · internal

Example Prompts

Once connected, try asking your AI agent:

PromptWhat it does
"Import this codebase into Composer"Scans your repo and builds the architecture diagram
"Create a new Composer diagram called Backend Architecture"Creates and auto-selects a new diagram
"Add a Redis cache between the API and the database in Composer"Adds a new node and edges to the diagram
"Add analytics monitoring to the Composer diagram"Adds observability nodes and connections
"Update the APIs I defined in Composer"Refreshes endpoint definitions on backend nodes
"Verify my Composer diagram"Checks for missing endpoints, orphaned nodes, etc.
"Link each Composer node to its source code"Associates diagram nodes with file paths

How It Works

Authentication is handled via OAuth 2.1 — your browser opens for a one-time consent flow, and you're connected. Tool calls are proxied to the Composer API at mcp.usecomposer.com. Your diagram data lives on Composer's servers. The MCP server itself is stateless.

Changes made through MCP are immediately visible on the Composer canvas via real-time WebSocket sync.

Development

bash
git clone https://github.com/olivergrabner/composer-mcpcd composer-mcpnpm installnpm run dev        # Watch mode (rebuilds on change)npm run build      # Production build

Links

License

MIT

來源：README.md，提交 ad37107

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.7最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分