esa MCP Server

resmi

esa.io için resmi Model Context Protocol (MCP) sunucusu - STDIO taşıma sürümü.

Esa MCP ile neler yapabilirsiniz?

  • Gönderileri arama ve okuma — esa_search_posts ile gönderileri bulun, ardından geri bağlantı sayısını ve gövde istatistiklerini görmek için numarasını kullanarak belirli bir gönderiyi esa_get_post ile alın.
  • İçerik oluşturma ve düzenleme — esa_create_post ile gönderi oluşturun, esa_update_post ile güncelleyin veya esa_append_post ve esa_prepend_post ile metin ekleyin.
  • Gönderi yaşam döngüsünü yönetme — esa_ship_post ile bir gönderiyi yayımlayın, esa_archive_post ile arşivleyin, esa_duplicate_post ile çoğaltın veya önceki bir sürüme geri alın.
  • Yorumları yönetme — Bir gönderideki veya takımdaki yorumları listeleyin, ardından esa_create_comment, esa_update_comment ve esa_delete_comment ile yorum oluşturun, güncelleyin veya silin.
  • Kategorileri ve takımları keşfetme — esa_get_all_category_paths ile kategori yollarına göz atın; esa_get_team_stats ve esa_get_team_members ile takım ayrıntılarını kontrol edin.
  • Bir gönderiyi özetleme — Belirli bir takımın gönderisinin yapılandırılmış özetini almak için esa_summarize_post istemini kullanın.

Dokümantasyon

esa MCP Server

License: MIT

日本語 | İngilizce

esa.io için resmi Model Context Protocol (MCP) sunucusu - STDIO aktarım sürümü.

Genel Bakış

Bu MCP sunucusu, yapay zekâ asistanları ile iş birliğine dayalı bir dokümantasyon platformu olan esa.io arasında sorunsuz entegrasyon sağlar. Yapay zekâ asistanlarının Model Context Protocol aracılığıyla esa belgelerini doğrudan okumasına, oluşturmasına, güncellemesine ve yönetmesine olanak tanır.

Kullanılabilir Araçlar

Takım Yönetimi

  • esa_get_teams - Kullanıcının erişebildiği esa takımlarını al
  • esa_get_team_stats - Takım istatistiklerini al (üyeler, gönderiler, yorumlar, yıldızlar, izlemeler, etkin kullanıcılar)
  • esa_get_team_tags - Takım gönderilerinde kullanılan tüm etiketleri sayılarıyla birlikte al
  • esa_get_team_members - Takım üyelerini rolleri ve profil bilgileriyle birlikte al

Gönderi Yönetimi

  • esa_search_posts - esa.io'daki gönderileri ara
  • esa_get_post - Gönderi numarasına göre belirli bir gönderiyi al (gövdenin karakter ve satır sayılarını içeren backlinks_count ve body_md_stats dahil)
  • esa_get_post_backlinks - Sayfalama ile belirli bir gönderiye referans veren gönderileri listele
  • esa_create_post - Etiketler, kategori ve WIP durumuyla yeni bir gönderi oluştur
  • esa_update_post - Mevcut gönderiyi güncelle (başlık, içerik, etiketler, kategori, WIP durumu)
  • esa_append_post - Gönderi gövdesinin sonuna içerik ekle (mevcut gövdeyi almaya gerek yoktur; yeni bir revizyon olarak kaydedilir)
  • esa_prepend_post - Gönderi gövdesinin başına içerik ekle (mevcut gövdeyi almaya gerek yoktur; yeni bir revizyon olarak kaydedilir)

Gönderi İşlemleri

  • esa_archive_post - Gönderiyi Archived/ kategorisine taşıyarak arşivle
  • esa_ship_post - Gönderiyi tamamlandı olarak işaretle (wip değerini false yap)
  • esa_duplicate_post - Bir gönderiyi çoğalt (aynı başlık ve gövdeyle yeni bir WIP gönderisi oluştur; takımlar arası çoğaltma da desteklenir)
  • esa_rollback_post_revision - Gönderiyi belirtilen revizyona geri al (geri yüklenen içerik yeni bir revizyon olarak kaydedilir; revizyon numarasını esa_get_post içindeki revision_number aracılığıyla kontrol et)

Yorum Yönetimi

  • esa_get_comment - Kimliğine göre belirli bir yorumu al
  • esa_create_comment - Bir gönderiye yeni yorum ekle
  • esa_update_comment - Mevcut bir yorumu güncelle
  • esa_delete_comment - Bir yorumu sil
  • esa_get_post_comments - Sayfalama ile belirli bir gönderinin yorumlarını al
  • esa_get_team_comments - Sayfalama ile takım yorumlarını al

Kategori Yönetimi

  • esa_get_categories - Belirli bir yol için kategorileri ve alt kategorileri al
  • esa_get_top_categories - Bir takımın tüm üst düzey kategorilerini al
  • esa_get_all_category_paths - Bir takımdaki tüm kategori yollarını al (gönderi sayılarıyla birlikte, filtrelemeyi destekler)
    • Kategori yapısını anlamak, organizasyon planlaması ve temizlik için idealdir
    • Filtre örnekleri: geliştirmeyle ilgili kategoriler için prefix: "dev", API ile ilgili kategoriler için match: "api"

Ekler

  • esa_get_attachment - esa gönderilerindeki ve yorumlarındaki bir ek dosyasını al
    • 30 MB'ın altındaki desteklenen görseller (JPEG, PNG, GIF, WebP) için base64 kodlu veri döndürür
    • Diğer dosya türleri, daha büyük görseller veya forceSignedUrl belirtildiğinde imzalı URL'ler döndürür (5 dakika geçerlidir)

Yardım ve Dokümantasyon

  • esa_get_search_options_help - esa arama sözdizimi belgelerini al
  • esa_get_markdown_syntax_help - esa Markdown sözdizimi belgelerini al
  • esa_search_help - Özellikler ve terminoloji için esa belgelerinde arama yap

Kullanılabilir Kaynaklar

  • esa_recent_posts - esa takımındaki yakın zamanda güncellenen gönderileri getir
    • Şablon: esa://teams/{teamName}/posts/recent
    • Döndürülen: Yakın zamanda güncellenen gönderilerin JSON listesi

Kullanılabilir İstemler

  • esa_summarize_post - Bir esa gönderisinin içeriğini özetle
    • Girdi: Takım adı ve gönderi numarası
    • Çıktı: Gönderi içeriğinin yapılandırılmış özeti

MCP İstemcisi Yapılandırması

MCP istemcisi yapılandırma dosyanıza ekleyin:

Gerekli Ortam Değişkenleri

  • ESA_ACCESS_TOKEN: Erişim belirteci
    • Gerekli kapsamlar: read write veya admin:comment read:post write:post read:category read:tag read:attachment read:team read:member
    • PAT v2 önerilir.
  • LANG: Kullanıcı arayüzü dili

Claude Desktop Örneği

claude_desktop_config.json dosyasına ekleyin:

Seçenek 1: Docker (Önerilen)

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_ACCESS_TOKEN",
        "-e",
        "LANG",
        "ghcr.io/esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

Seçenek 2: npx

{
  "mcpServers": {
    "esa": {
      "command": "/Users/your-username/.nodenv/shims/npx",
      "args": ["@esaio/esa-mcp-server"],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

Not: /path/to/your/node değerini which node komutunun çıktısıyla değiştirin.

Kayıt Defteri

Bu paket, kayıtlı araçları, kaynakları ve istemleri sunan registry.json dosyasını paket kök dizininde içerir. Sunucuyu başlatmadan programatik olarak kullanılabilir:

import registry from "@esaio/esa-mcp-server/registry.json" with {
  type: "json",
};

Şema:

{
  "tools": [{ "name": "esa_get_teams" }, "..."],
  "resources": [
    {
      "name": "esa_recent_posts",
      "uriTemplate": "esa://teams/{teamName}/posts/recent"
    }
  ],
  "prompts": [{ "name": "esa_summarize_post" }]
}

Dosya, npm run build:registry tarafından yeniden oluşturulur ve bir CI denetimi, kayıtlı öğelerle eşzamanlı kalmasını sağlar.

Bağlantılar

Destek


esa ekibi tarafından ❤️ ile hazırlandı