MCP ECharts

AI MCP ile Apache ECharts dinamik olarak oluşturun, grafik oluşturma ve veri analizi için. Ayrıca grafik, çizelge, harita oluşturmak için mcp-server-chart kullanabilirsiniz.

✨ Özellikler

• ECharts özellik ve sözdiziminin tamamı tam olarak desteklenir; veri, stil, tema ve daha fazlası dahil.
• png, svg ve option formatlarına dışa aktarmayı destekler, modelin çok aşamalı doğru sözdizimi ve grafik çıkışını kolaylaştırmak için ECharts doğrulaması ile.
• MinIO Entegrasyonu, grafikleri MinIO nesne depolamasında saklayın ve daha iyi performans ve paylaşım yetenekleri için Base64 verileri yerine URL'ler döndürün.
• Hafif, sıfır bağımlılık ile kolayca kurulabilir.
• Son derece güvenli, tamamen yerel olarak oluşturulur, herhangi bir uzak hizmete bağlı değildir.

🤖 Kullanım

Ön Koşullar

• Node.js 18 veya daha yüksek sürüm gereklidir.

Masaüstü Uygulamaları (stdio transport)

Masaüstü APP ile kullanmak için, Claude, VSCode, Cline, Cherry Studio vb. gibi, aşağıdaki MCP sunucu konfigürasyonunu ekleyin. Mac sisteminde:

{
  "mcpServers": {
    "mcp-echarts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-echarts"
      ]
    }
  }
}

Windows sisteminde:

{
  "mcpServers": {
    "mcp-echarts": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-echarts"
      ]
    }
  }
}

Ayrıca modelscope, glama.ai, smithery.ai veya HTTP, SSE Protokolü ile diğer platformlarda kullanabilirsiniz.

🚰 SSE veya Streamable transport ile çalıştırma

Paketi global olarak kurun.

npm install -g mcp-echarts

Sunucuyu tercih ettiğiniz transport seçeneği ile çalıştırın:

# SSE transport için (varsayılan endpoint: /sse)
mcp-echarts -t sse

# Streamable transport için özel endpoint ile
mcp-echarts -t streamable

Daha sonra sunucuya şu adreslerde erişebilirsiniz:

• SSE transport: http://localhost:3033/sse
• Streamable transport: http://localhost:3033/mcp

🎮 CLI Seçenekleri

MCP sunucusunu çalıştırırken aşağıdaki CLI seçeneklerini de kullanabilirsiniz. Komut seçenekleri için -h ile CLI'yi çalıştırın.

MCP ECharts CLI

Options:
  --transport, -t  Transport protokolünü belirtin: "stdio", "sse" veya "streamable" (varsayılan: "stdio")
  --port, -p       SSE veya streamable transport için portu belirtin (varsayılan: 3033)
  --endpoint, -e   Transport için endpoint belirtin:
                    - SSE için: varsayılan "/sse"
                    - streamable için: varsayılan "/mcp"
  --help, -h       Bu yardım mesajını göster

🗂️ MinIO Konfigürasyonu (İsteğe Bağlı)

Daha iyi performans ve paylaşım yetenekleri için, MinIO nesne depolamasını yapılandırarak grafik resimlerini Base64 verileri yerine URL'ler olarak saklayabilirsiniz.

[!NOTE] MinIO yapılandırılmamışsa veya kullanılamıyorsa, sistem otomatik olarak Base64 veri çıkışına döner, uyumluluğu sağlar.

Aşağıdaki MinIO nesne depolama sağlayıcılarıyla entegre edebiliriz.

• MinIO: Yüksek performanslı, S3 uyumlu nesne depolaması. Doğrudan entegrasyon için MinIO JavaScript Client kullanın.
• Amazon S3: Uyumlu API endpoint ile AWS SDK kullanın.
• Alibaba Cloud OSS: OSS hizmetleri için Alibaba Cloud SDK kullanın.
• Google Cloud Storage: Google Cloud SDK veya uyumlu API kullanarak entegre edin.
• Microsoft Azure Blob Storage: Blob depolama erişimi için Azure SDK kullanın.
• Tencent Cloud COS: COS entegrasyonu için Tencent Cloud SDK kullanın.

Ayrıca, MinIO'yu yerel olarak ücretsiz olarak kurabilirsiniz.

1. MinIO'yu yerel olarak kurun ve başlatın:

   # MinIO'yu indirin (macOS örneği)
   brew install minio/stable/minio
   
   # MinIO sunucusunu başlatın
   minio server ~/minio-data --console-address :9001
   

2. Ortam değişkenlerini yapılandırın:

   # Örnek ortam dosyasını kopyalayın
   cp .env.example .env
   
   # MinIO ayarlarınız ile .env'i düzenleyin
   MINIO_ENDPOINT=localhost
   MINIO_PORT=9000
   MINIO_USE_SSL=false
   MINIO_ACCESS_KEY=minioadmin
   MINIO_SECRET_KEY=minioadmin
   MINIO_BUCKET_NAME=mcp-echarts
   

🔨 Geliştirme

Bağımlılıkları kurun:

npm install

Sunucuyu oluşturun:

npm run build

MCP sunucusunu başlatın:

npm run start

🧑🏻‍💻 Katkı Sağlayanlar

• lyw405: 15+ grafik MCP aracını destekler. #2
• 2niuhe: SSE ve Streaming HTTP ile MCP desteği. #17
• susuperli: Grafik resim base64'ü kaydetmek ve URL döndürmek için MinIO kullanın. #10
• BQXBQX: node-canvas yerine @napi-rs/canvas kullanın. #3
• Meet-student: Tüm grafik araçları için outputType şeması ekleyin. #24
• hustcc: Repo'yu başlatıyor.

📄 Lisans

MIT@hustcc.