AI Diagram Maker MCP

resmi

AI Diagram Maker için MCP sunucusu — Cursor, Claude Desktop, Claude Code veya MCP uyumlu herhangi bir AI aracısı içinde doğrudan güzel yazılım mühendisliği diyagramları oluşturun.

GitHub

Dokümantasyon

AI Diagram Maker MCP Sunucusu

AI Diagram Maker için MCP sunucusu — doğrudan Cursor, Claude Desktop, Claude Code veya herhangi bir MCP uyumlu yapay zeka ajanı içinde güzel yazılım mühendisliği diyagramları oluşturun.

ai-diagram-maker-mcp 🌐 ☁️ - Düz İngilizce açıklamalardan profesyonel yazılım diyagramları oluşturun.

Özellikler

5 araç her giriş türünü kapsar: doğal dil metni, kod, ASCII diyagramı, görseller ve Mermaid
Satır içi görüntüleme — diyagramlar MCP Apps UI kullanarak doğrudan sohbette görünür, indirme gerekmez
Yanıtlarda diyagram URL'si — diyagramı görüntülemek ve düzenlemek için tarayıcınızda açın
5 diyagram türü: akış şeması, sıralı diyagram, ERD, sistem mimarisi, UML
Hem stdio (yerel) hem de HTTP/Streamable HTTP (uzak) aktarımlarını destekler

Ön Koşullar

Node.js 18+
Bir AI Diagram Maker hesabı ve API anahtarı

Barındırılan MCP sunucusu

Genel MCP uç noktası https://mcp.aidiagrammaker.com/mcp (Streamable HTTP)** şeklindedir. Bu seçenek için kurulum gerektirmez.

Kimlik Doğrulama (HTTP)

Uzak HTTP istemcileri için, API anahtarınızı her istekte gönderin — ortam değişkenleri aracılığıyla değil:

X-ADM-API-Key: <your_api_key> (önerilir), veya
Authorization: Bearer <your_api_key>

AI Diagram Maker hesabınızdaki API anahtarını kullanın (bkz. Ön Koşullar).

Uzak sunucu JSON örneği

Bunu istemcinizin MCP yapılandırmasına ekleyin (API anahtarı yer tutucusunu değiştirin):

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

Kurulum

Seçenek A — barındırılan sunucu (önerilir)

Yukarıdaki uzak sunucu JSON örneğini kullanın ve MCP istemci yapılandırması ile istemcinize bağlayın. Genel kurulum gerekmez.

Seçenek B — npx ile yerel olarak çalıştırın

Kalıcı kurulum gerektirmez — npx paketi talep üzerine çalıştırır. Paket adı ai-diagram-maker-mcp şeklindedir; her çağrının en yeni sürümü çözümlemesini istiyorsanız @latest ekleyin (tek seferlik çalıştırmalar ve claude mcp add için önerilir).

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

MCP istemci yapılandırması

Cursor

Uzak (önerilir)

Uzak sunucu JSON örneğini kullanarak ~/.cursor/mcp.json veya Ayarlar → MCP kısmına ekleyin. Bu kurulum için ortam değişkeni gerekmez.

Yerel (stdio)

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

İsteğe bağlı: hata ayıklama günlüğü için "ADM_DEBUG": "1" değerini env kısmına ekleyin — bkz. Ortam değişkenleri.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows) kısmına ekleyin:

{
  "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

HTTP aktarımı (yerel veya kendi kendine barındırılan)

Kendiniz bir HTTP sunucusu çalıştırmak için (Kimlik Doğrulama (HTTP) ile aynı başlık tabanlı kimlik doğrulama):

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

Sunucu $PORT veya 3001 üzerinde dinler. İstemcileri /mcp adresine yönlendirin ve her istekle birlikte yukarıdaki başlıkları kullanarak API anahtarını gönderin.

Ortam değişkenleri

Değişken	Gerekli	Varsayılan	Açıklama
`ADM_API_KEY`	Evet (yalnızca stdio)	—	AI Diagram Maker API anahtarınız (yalnızca stdio aktarımı; uzak HTTP istemcileri başlıkları kullanır — bkz. Kimlik Doğrulama (HTTP))
`ADM_BASE_URL`	Hayır	`https://app.aidiagrammaker.com`	Yerel/hazırlık API'si için geçersiz kılma; ayrıca araç yanıtlarındaki diyagram URL'leri için temel olarak kullanılır
`ADM_DEBUG`	Hayır	—	Yapay zeka ajanından gelen istek parametrelerini ve AI Diagram Maker API'sine gönderilen yükü günlüğe kaydetmek için `1`, `true` veya `yes` olarak ayarlayın. Günlükler stderr'e gider. Cursor'da, sunucu günlüklerini okumak için Çıktı'yı açın, MCP veya ai-diagram-maker kanalını seçin.

Araçlar

`generate_diagram_from_text`

Doğal dil açıklamasından bir diyagram oluşturun.

Parametre	Tür	Gerekli	Açıklama
`content`	string	Evet	Diyagramın doğal dil açıklaması
`diagramType`	enum	Hayır	flowchart, sequence, erd, system_architecture, uml
`prompt`	string	Hayır	Ek stil/düzen talimatı

Örnek istemler:

"API ağ geçidi, kimlik doğrulama servisi, kullanıcı servisi ve PostgreSQL veritabanı ile bir mikroservis mimarisi oluşturun"
"JWT belirteci oluşturma ile kullanıcı giriş akışı için bir sıralı diyagram çizin"
"Vercel'e dağıtılan bir Next.js uygulaması için CI/CD hattını gösterin"

`generate_diagram_from_json`

Bir JSON yapısını diyagrama dönüştürün (API yanıtları, veritabanı şemaları, yapılandırma dosyaları için harikadır).

Parametre	Tür	Gerekli	Açıklama
`content`	string	Evet	Görselleştirilecek JSON dizesi
`prompt`	string	Hayır	JSON'un nasıl yorumlanacağı
`diagramType`	enum	Hayır	Tercih edilen diyagram türü

`generate_diagram_from_ascii`

ASCII sanatını cilalı bir diyagrama dönüştürün.

Parametre	Tür	Gerekli	Açıklama
`content`	string	Evet	Ham ASCII sanat diyagramı
`prompt`	string	Hayır	İşleme talimatları
`diagramType`	enum	Hayır	Tercih edilen diyagram türü

`generate_diagram_from_image`

Bir beyaz tahta fotoğrafını, ekran görüntüsünü veya herhangi bir görseli temiz bir diyagrama dönüştürün.

Parametre	Tür	Gerekli	Açıklama
`content`	string	Evet	Genel görsel URL'si veya base64 veri URI'si
`prompt`	string	Hayır	Neyin çıkarılacağı veya nasıl işleneceği
`diagramType`	enum	Hayır	Tercih edilen çıktı diyagram türü

`generate_diagram_from_mermaid`

Bir Mermaid diyagram tanımını D2'ye dönüştürün ve bir PNG görseli döndürün.

Parametre	Tür	Gerekli	Açıklama
`content`	string	Evet	Mermaid diyagram kaynağı (örn. flowchart, sequenceDiagram, erDiagram)
`prompt`	string	Hayır	İsteğe bağlı düzen veya stil talimatı
`diagramType`	enum	Hayır	Dönüştürülen çıktı için tercih edilen diyagram türü

Tetikleyici anahtar kelimeler

Yapay zeka ajanı, aşağıdaki gibi ifadeler kullandığınızda otomatik olarak doğru aracı seçecektir:

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

Yerel geliştirici kurulumu

Depoyu klonlamak, yerel olarak derlemek ve MCP sunucusunu Node ile çalıştırmak için bu adımları kullanın.

1. Depoyu klonlayın

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

2. Bağımlılıkları yükleyin

npm install

3. (İsteğe bağlı) API istemcisini yeniden oluşturun

AI Diagram Maker OpenAPI şemasını veya yapılandırmasını değiştirirseniz, istemciyi yeniden oluşturun:

npm run generate

4. Derleyin

npm run build

Bu, TypeScript'i derler ve MCP uygulama arayüzünü dist/ içine oluşturur. Sunucu giriş noktası dist/index.js şeklindedir.

5. Yerel MCP sunucusunu çalıştırın

stdio (varsayılan) — Cursor, Claude Desktop vb. ile kullanım için:

ADM_API_KEY=your_api_key node dist/index.js

Veya npm betiğini kullanın:

ADM_API_KEY=your_api_key npm start

HTTP aktarımı — uzak istemciler veya test için (Kimlik Doğrulama (HTTP) ile aynı başlıklar):

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

Veya:

ADM_API_KEY=your_api_key npm run start:http

HTTP sunucusu $PORT üzerinde dinler (varsayılan 3001).

6. Yerel sunucuyu Cursor'da kullanın

Cursor'u Ayarlar → MCP (veya ~/.cursor/mcp.json) aracılığıyla derlenmiş sunucunuza yönlendirin:

{
  "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"
      }
    }
  }
}

/absolute/path/to/ai-diagram-maker-mcp kısmını klonlanmış deponuzun gerçek yolu ile değiştirin. Yapılandırmayı değiştirdikten sonra Cursor'u yeniden başlatın veya MCP sunucularını yeniden yükleyin.

Hata ayıklama günlüğü için "ADM_DEBUG": "1" değerini env kısmına ekleyin — bkz. Ortam değişkenleri.

Lisans

MIT