composer-mcp
Visual architecture canvas for AI agents. Create and modify interactive system diagrams through MCP with real-time updat
MCP server that gives AI coding agents a visual architecture canvas to design, visualize, and evolve software architecture diagrams in real-time.
About composer-mcp
composer-mcp is a community-built MCP server published by OliverGrabner that provides AI assistants with tools and capabilities via the Model Context Protocol. Visual architecture canvas for AI agents. Create and modify interactive system diagrams through MCP with real-time updat It is categorized under search web. This server exposes 16 tools that AI clients can invoke during conversations and coding sessions.
How to install
You can install composer-mcp in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
composer-mcp is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (16)
List all your diagrams
Create a new diagram and auto-select it for this session
Select which diagram to work on for this session
Rename the currently selected diagram
Get the full architecture diagram - all nodes and edges
Composer MCP Server
Give your AI coding agent an architecture canvas.
Design, visualize, and evolve software architecture diagrams - right from your IDE.
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:
claude mcp add --transport http composer https://mcp.usecomposer.com
Cursor — create .cursor/mcp.json in your project root:
{
"mcpServers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
Your browser will open for authorization on first use.
Claude Code
claude mcp add --transport http composer https://mcp.usecomposer.com
Cursor
Create .cursor/mcp.json in your project root:
{
"mcpServers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
Codex
codex mcp add composer -- npx -y @usecomposer/mcp --stdio
VS Code (Copilot Chat)
Create .vscode/mcp.json in your project root:
{
"servers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
VS Code (Cline)
Open Cline sidebar > Settings (gear icon) > MCP Servers > Add Remote Server:
{
"mcpServers": {
"composer": {
"type": "http",
"url": "https://mcp.usecomposer.com"
}
}
}
VS Code (Continue)
Add to .continue/config.yaml:
mcpServers:
- name: composer
url: https://mcp.usecomposer.com
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"composer": {
"serverUrl": "https://mcp.usecomposer.com"
}
}
}
Note: Windsurf uses
"serverUrl"instead of"url".
OpenCode
Create opencode.json in your project root:
{
"mcp": {
"composer": {
"type": "remote",
"url": "https://mcp.usecomposer.com"
}
}
}
Tools
Diagram Management
| Tool | Description |
|---|---|
list_diagrams | List all your diagrams. Call this first to find which diagram to work on |
create_diagram | Create a new diagram and auto-select it for this session |
select_diagram | Select which diagram to work on for this session |
rename_diagram | Rename the currently selected diagram |
Note: Call
list_diagramsthenselect_diagram(orcreate_diagram) before using other tools.
Read
| Tool | Description |
|---|---|
get_graph | Get the full architecture diagram - all nodes and edges |
get_node | Get details for a single node including connected edges |
search_graph | Search nodes and edges by keyword |
get_screenshot | Get a PNG thumbnail of the diagram from the last auto-save |
Write
| Tool | Description |
|---|---|
upsert_node | Create or update a node (service, database, queue, etc.) |
upsert_edge | Create or update a connection between two nodes |
define_api | Define API endpoints on a backend service node |
delete_element | Delete a node or edge from the diagram |
link_path | Link a node to a file or folder in your codebase |
Plan & Verify
| Tool | Description |
|---|---|
verify_diagram | Check for issues like missing endpoints or orphaned nodes |
plan_import | Step-by-step workflow for importing an existing codebase |
get_guide | Reference 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:
| Prompt | What 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
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
Links
- Composer - the visual architecture canvas
- MCP Protocol - Model Context Protocol spec
- Issues - bug reports and feature requests
License
MIT
Alternatives
Related Skills
Browse all skillsOfficial Google SEO guide covering search optimization, best practices, Search Console, crawling, indexing, and improving website search visibility based on official Google documentation
Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and usability, reviewing UI strings, or improving existing interface copy. Applies UX writing best practices based on four quality standards — purposeful, concise, conversational, and clear. Includes accessibility guidelines, research-backed benchmarks (sentence length, comprehension rates, reading levels), expanded error patterns, tone adaptation frameworks, and comprehensive reference materials.
Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications. Triggers include "browse", "navigate to", "go to website", "extract data from webpage", "screenshot", "web scraping", "fill out form", "click on", "search for on the web". When taking actions be as specific as possible.
Research a topic from the last 30 days on Reddit + X + Web, become an expert, and write copy-paste-ready prompts for the user's target tool.
Use this skill for requests related to web research; it provides a structured approach to conducting comprehensive web research
Comprehensive research, analysis, and content extraction system. USE WHEN user says 'research' (ANY form - this is the MANDATORY trigger), 'do research', 'extensive research', 'quick research', 'minor research', 'research this', 'find information', 'investigate', 'extract wisdom', 'extract alpha', 'analyze content', 'can't get this content', 'use fabric', OR requests any web/content research. Supports three research modes (quick/standard/extensive), deep content analysis, intelligent retrieval, and 242+ Fabric patterns. NOTE: For due diligence, OSINT, or background checks, use OSINT skill instead.