AI Diagram Maker MCP

AI Diagram Maker MCP Server

Máy chủ MCP cho AI Diagram Maker — tạo các sơ đồ kỹ thuật phần mềm đẹp mắt trực tiếp bên trong Cursor, Claude Desktop, Claude Code, hoặc bất kỳ tác nhân AI tương thích MCP nào.

• ai-diagram-maker-mcp 🌐 ☁️ - Tạo sơ đồ phần mềm chuyên nghiệp từ mô tả bằng tiếng Anh thông thường.

Tính năng

• 5 công cụ bao quát mọi loại đầu vào: văn bản ngôn ngữ tự nhiên, mã, sơ đồ ASCII, hình ảnh và Mermaid
• Kết xuất nội tuyến — sơ đồ xuất hiện trực tiếp trong cuộc trò chuyện bằng giao diện MCP Apps, không cần tải xuống
• URL sơ đồ trong phản hồi — mở trong trình duyệt để xem và chỉnh sửa sơ đồ
• 5 loại sơ đồ: lưu đồ, sơ đồ tuần tự, ERD, kiến trúc hệ thống, UML
• Hỗ trợ cả hai phương thức truyền tải stdio (cục bộ) và HTTP/Streamable HTTP (từ xa)

Nội dung

• Điều kiện tiên quyết
• Máy chủ MCP được lưu trữ
• Cài đặt
• Cấu hình máy khách MCP
• Biến môi trường
• Công cụ
• Từ khóa kích hoạt
• Thiết lập nhà phát triển cục bộ
• Giấy phép

Điều kiện tiên quyết

1. Node.js 18+
2. Tài khoản AI Diagram Maker và khóa API

Máy chủ MCP được lưu trữ

Điểm cuối MCP công khai là https://mcp.aidiagrammaker.com/mcp (HTTP có thể truyền phát). Không cần cài đặt gì cho tùy chọn này.

Xác thực (HTTP)

Đối với máy khách HTTP từ xa, gửi khóa API của bạn trong mỗi yêu cầu — không qua biến môi trường:

• X-ADM-API-Key: <your_api_key> (khuyến nghị), hoặc
• Authorization: Bearer <your_api_key>

Sử dụng khóa API từ tài khoản AI Diagram Maker của bạn (xem Điều kiện tiên quyết).

Ví dụ JSON máy chủ từ xa

Hợp nhất phần này vào cấu hình MCP của máy khách (thay thế phần giữ chỗ khóa API):

{
  "mcpServers": {
    "ai-diagram-maker": {
      "url": "https://mcp.aidiagrammaker.com/mcp",
      "headers": {
        "X-ADM-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Cài đặt

Tùy chọn A — máy chủ được lưu trữ (khuyến nghị)

Sử dụng ví dụ JSON máy chủ từ xa ở trên và kết nối nó vào máy khách của bạn bằng Cấu hình máy khách MCP. Không cần cài đặt toàn cục.

Tùy chọn B — chạy cục bộ với npx

Không cần cài đặt vĩnh viễn — npx chạy gói theo yêu cầu. Tên gói là ai-diagram-maker-mcp; thêm @latest nếu bạn muốn mỗi lần gọi đều phân giải bản phát hành mới nhất (khuyến nghị cho các lần chạy một lần và claude mcp add).

ADM_API_KEY=your_api_key npx ai-diagram-maker-mcp@latest

Cấu hình máy khách MCP

Cursor

Từ xa (khuyến nghị)

Thêm vào ~/.cursor/mcp.json hoặc Cài đặt → MCP bằng cách sử dụng ví dụ JSON máy chủ từ xa. Không yêu cầu biến môi trường cho thiết lập này.

Cục bộ (stdio)

{
  "mcpServers": {
    "ai-diagram-maker": {
      "command": "npx",
      "args": ["-y", "ai-diagram-maker-mcp@latest"],
      "env": {
        "ADM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tùy chọn: thêm "ADM_DEBUG": "1" vào env để ghi nhật ký gỡ lỗi — xem Biến môi trường.

Claude Desktop

Thêm vào ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hoặc %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ai-diagram-maker": {
      "command": "npx",
      "args": ["-y", "ai-diagram-maker-mcp@latest"],
      "env": {
        "ADM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

macOS

claude mcp add ai-diagram-maker -t stdio -e ADM_API_KEY=<api_key> -- npx -y ai-diagram-maker-mcp@latest

Windows

claude mcp add ai-diagram-maker \
  --command "npx" \
  --args "-y,ai-diagram-maker-mcp@latest" \
  --env ADM_API_KEY=your_api_key_here

Truyền tải HTTP (cục bộ hoặc tự lưu trữ)

Để tự chạy máy chủ HTTP (cùng xác thực dựa trên tiêu đề như Xác thực (HTTP)):

npx ai-diagram-maker-mcp@latest --transport http

Máy chủ lắng nghe trên $PORT hoặc 3001. Trỏ máy khách đến /mcp và gửi khóa API với mỗi yêu cầu bằng các tiêu đề ở trên.

Biến môi trường

Biến	Bắt buộc	Mặc định	Mô tả
ADM_API_KEY	Có (chỉ stdio)	—	Khóa API AI Diagram Maker của bạn (chỉ dành cho truyền tải stdio; máy khách HTTP từ xa sử dụng tiêu đề — xem Xác thực (HTTP))
ADM_BASE_URL	Không	https://app.aidiagrammaker.com	Ghi đè cho API cục bộ/dàn dựng; cũng được dùng làm cơ sở cho URL sơ đồ trong phản hồi công cụ
ADM_DEBUG	Không	—	Đặt thành 1, true, hoặc yes để ghi nhật ký tham số yêu cầu từ tác nhân AI và tải trọng gửi đến API AI Diagram Maker. Nhật ký đi đến stderr. Trong Cursor, mở Output, chọn kênh MCP hoặc ai-diagram-maker để đọc nhật ký máy chủ.

Công cụ

generate_diagram_from_text

Tạo sơ đồ từ mô tả ngôn ngữ tự nhiên.

Tham số	Loại	Bắt buộc	Mô tả
content	chuỗi	Có	Mô tả ngôn ngữ tự nhiên của sơ đồ
diagramType	enum	Không	flowchart, sequence, erd, system_architecture, uml
prompt	chuỗi	Không	Hướng dẫn bổ sung về kiểu dáng/bố cục

Ví dụ lời nhắc:

• "Tạo kiến trúc microservices với API gateway, auth service, user service, và cơ sở dữ liệu PostgreSQL"
• "Vẽ sơ đồ tuần tự cho luồng đăng nhập người dùng với việc tạo JWT token"
• "adm hiển thị pipeline CI/CD cho ứng dụng Next.js triển khai lên Vercel"

---

generate_diagram_from_json

Chuyển đổi cấu trúc JSON thành sơ đồ (tuyệt vời cho phản hồi API, lược đồ cơ sở dữ liệu, tệp cấu hình).

Tham số	Loại	Bắt buộc	Mô tả
content	chuỗi	Có	Chuỗi JSON để trực quan hóa
prompt	chuỗi	Không	Cách diễn giải JSON
diagramType	enum	Không	Loại sơ đồ ưu tiên

---

generate_diagram_from_ascii

Chuyển đổi nghệ thuật ASCII thành sơ đồ tinh tế.

Tham số	Loại	Bắt buộc	Mô tả
content	chuỗi	Có	Sơ đồ nghệ thuật ASCII thô
prompt	chuỗi	Không	Hướng dẫn kết xuất
diagramType	enum	Không	Loại sơ đồ ưu tiên

---

generate_diagram_from_image

Chuyển đổi ảnh chụp bảng trắng, ảnh chụp màn hình, hoặc bất kỳ hình ảnh nào thành sơ đồ sạch sẽ.

Tham số	Loại	Bắt buộc	Mô tả
content	chuỗi	Có	URL hình ảnh công khai hoặc URI dữ liệu base64
prompt	chuỗi	Không	Nội dung cần trích xuất hoặc cách kết xuất
diagramType	enum	Không	Loại sơ đồ đầu ra ưu tiên

---

generate_diagram_from_mermaid

Chuyển đổi định nghĩa sơ đồ Mermaid sang D2 và trả về hình ảnh PNG.

Tham số	Loại	Bắt buộc	Mô tả
content	chuỗi	Có	Nguồn sơ đồ Mermaid (ví dụ: flowchart, sequenceDiagram, erDiagram)
prompt	chuỗi	Không	Hướng dẫn tùy chọn về bố cục hoặc kiểu dáng
diagramType	enum	Không	Loại sơ đồ ưu tiên cho đầu ra đã chuyển đổi

Từ khóa kích hoạt

Tác nhân AI sẽ tự động chọn đúng công cụ khi bạn sử dụng các cụm từ như:

• adm ...
• ai diagram maker ...
• create a diagram of ...
• show me a flowchart / sequence diagram / ERD / architecture ...
• visualise / draw / diagram ...

Thiết lập nhà phát triển cục bộ

Sử dụng các bước này để sao chép kho lưu trữ, xây dựng cục bộ và chạy máy chủ MCP với Node.

1. Sao chép kho lưu trữ

git clone https://github.com/erajasekar/ai-diagram-maker-mcp.git
cd ai-diagram-maker-mcp

2. Cài đặt phụ thuộc

npm install

3. (Tùy chọn) Tạo lại máy khách API

Nếu bạn thay đổi đặc tả OpenAPI hoặc cấu hình của AI Diagram Maker, hãy tạo lại máy khách:

npm run generate

4. Xây dựng

npm run build

Lệnh này biên dịch TypeScript và xây dựng giao diện ứng dụng MCP vào dist/. Điểm vào máy chủ là dist/index.js.

5. Chạy máy chủ MCP cục bộ

stdio (mặc định) — để sử dụng với Cursor, Claude Desktop, v.v.:

ADM_API_KEY=your_api_key node dist/index.js

Hoặc sử dụng tập lệnh npm:

ADM_API_KEY=your_api_key npm start

Truyền tải HTTP — cho máy khách từ xa hoặc kiểm thử (cùng tiêu đề như Xác thực (HTTP)):

ADM_API_KEY=your_api_key node dist/index.js --transport http

Hoặc:

ADM_API_KEY=your_api_key npm run start:http

Máy chủ HTTP lắng nghe trên $PORT (mặc định 3001).

6. Sử dụng máy chủ cục bộ trong Cursor

Trỏ Cursor đến máy chủ đã xây dựng của bạn qua Cài đặt → MCP (hoặc ~/.cursor/mcp.json):

{
  "mcpServers": {
    "ai-diagram-maker": {
      "command": "node",
      "args": ["/absolute/path/to/ai-diagram-maker-mcp/dist/index.js"],
      "env": {
        "ADM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Thay thế /absolute/path/to/ai-diagram-maker-mcp bằng đường dẫn thực tế đến kho lưu trữ đã sao chép của bạn. Sau khi thay đổi cấu hình, khởi động lại Cursor hoặc tải lại các máy chủ MCP.

Để ghi nhật ký gỡ lỗi, thêm "ADM_DEBUG": "1" vào env — xem Biến môi trường.

Giấy phép

MIT