iagogfe/excalidraw-icons-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

32 stars 1 forks 质量 82 趋势 19MIT

Repository Install

Excalidraw MCP 服务器，具备真实厂商图标搜索与插入功能（AWS/Azure/GCP/OCI/Kubernetes），用于 AI 构建的架构图——实时画布，31 个工具

概览

一个基于的 Excalidraw MCP 服务器。AI 代理会一次性在实时画布上绘制架构图，使用官方 AWS、Azure、GCP、OCI 和 Kubernetes 图标——而非通用矩形。有两点使其与上游分支区分开来： - ⚡ ：单批次元素创建，更精简的依赖树，以及优化的画布加载路径——减少每个图的往返次数。- 🎨 ： search_official_icon + add_image 拉取实际供应商图标，而非仅绘制近似的形状。 - ：31 个基于模型上下文协议的工具（Claude Desktop、Cursor、Codex CLI 等）——图标搜索与插入、元素 CRUD、自动布局、各域图示规范 - ：Claude Code、Codex CLI 及其他技能启用代理的可移植技能关键词：Excalidraw MCP 服务器、AWS/Azure/GCP 图标、AI 架构图、图解即代码、Claude 代码技能、Codex CLI 技能、光标 MCP、Mermaid 到 Excalidraw。

概述（AI 翻译）

一个更快的Excalidraw MCP服务器，基于真实厂商图标构建。AI代理会用官方AWS、Azure、GCP、OCI和Kubernetes图标——在实时画布上一次性绘制架构图——而非通用矩形——他们可以看到并细化。

有两点使其与上游分支区分开来：

⚡ 速度：单批次元素创建，更精简的依赖树，以及优化的画布加载路径——每个图的往返次数更少。
🎨 真实图标：search_official_icon + add_image 拉取实际商人图标，而不是绘制仅近似它们的形状。

该仓库提供：

MCP 服务器：基于模型上下文协议的31个工具（Claude Desktop、Cursor、Codex CLI 等）——图标搜索与插入、元素 CRUD、自动布局、每个域的图表约定
Agent Skill：适用于 Claude Code、Codex CLI 及其他技能启用代理的便携技能

关键词：Excalidraw MCP 服务器、AWS/Azure/GCP 图标、AI 架构图、图解即代码、Claude 代码技能、Codex CLI 技能、光标 MCP、Mermaid 到 Excalidraw。

演示

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Excalidraw Icons MCP

A faster Excalidraw MCP server built around real vendor icons. AI agents draw architecture diagrams with official AWS, Azure, GCP, OCI, and Kubernetes icons — not generic rectangles — in one-shot batches on a live canvas they can see and refine.

Two things set it apart from the upstream fork it grew from:

⚡ Speed: single-batch element creation, a leaner dependency tree, and an optimized canvas load path — fewer round-trips per diagram.
🎨 Real icons: search_official_icon + add_image pull actual vendor icons instead of drawing shapes that only approximate them.

This repo provides:

MCP Server: 31 tools over the Model Context Protocol (Claude Desktop, Cursor, Codex CLI, etc.) — icon search & insertion, element CRUD, auto-layout, per-domain diagram conventions
Agent Skill: Portable skill for Claude Code, Codex CLI, and other skill-enabled agents

Keywords: Excalidraw MCP server, AWS/Azure/GCP icons, AI architecture diagrams, diagrams as code, Claude Code skill, Codex CLI skill, Cursor MCP, Mermaid to Excalidraw.

Demo

An AI agent builds a serverless AWS architecture step by step with Route 53, CloudFront, API Gateway, Lambda, DynamoDB, SQS, and S3.

Demo
What It Is
How We Differ from the Official Excalidraw MCP
What’s New
Quick Start (Local)
Quick Start (Docker)
Configure MCP Clients
Agent Skill (Optional)
MCP Tools (31 Total)
Vendor Icon Packs
Testing
Troubleshooting
Known Issues / TODO
Development

What It Is

This repo contains two separate processes:

Canvas server: web UI + REST API + WebSocket updates (default http://127.0.0.1:3000)
MCP server: exposes MCP tools over stdio; syncs to the canvas via EXPRESS_SERVER_URL

在 GitHub 查看完整 README

安装

docker run -i --rm -e EXPRESS_SERVER_URL=http://host.docker.internal:3000 -e ENABLE_CANVAS_SYNC=true ghcr.io/iagogfe/excalidraw-icons-mcp:latest

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "excalidraw": {
      "command": "node",
      "args": ["/absolute/path/to/excalidraw-icons-mcp/dist/index.js"],
      "env": {
        "EXPRESS_SERVER_URL": "http://127.0.0.1:3000",
        "ENABLE_CANVAS_SYNC": "true"
      }
    }
  }
}