esa MCP Server
resmiesa.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_postsile 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önderiyiesa_get_postile alın. - İçerik oluşturma ve düzenleme —
esa_create_postile gönderi oluşturun,esa_update_postile güncelleyin veyaesa_append_postveesa_prepend_postile metin ekleyin. - Gönderi yaşam döngüsünü yönetme —
esa_ship_postile bir gönderiyi yayımlayın,esa_archive_postile arşivleyin,esa_duplicate_postile ç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_commentveesa_delete_commentile yorum oluşturun, güncelleyin veya silin. - Kategorileri ve takımları keşfetme —
esa_get_all_category_pathsile kategori yollarına göz atın;esa_get_team_statsveesa_get_team_membersile 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_postistemini kullanın.
Dokümantasyon
esa MCP Server
日本語 | İ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ı alesa_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 alesa_get_team_members- Takım üyelerini rolleri ve profil bilgileriyle birlikte al
Gönderi Yönetimi
esa_search_posts- esa.io'daki gönderileri araesa_get_post- Gönderi numarasına göre belirli bir gönderiyi al (gövdenin karakter ve satır sayılarını içerenbacklinks_countvebody_md_statsdahil)esa_get_post_backlinks- Sayfalama ile belirli bir gönderiye referans veren gönderileri listeleesa_create_post- Etiketler, kategori ve WIP durumuyla yeni bir gönderi oluşturesa_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şivleesa_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_postiçindekirevision_numberaracılığıyla kontrol et)
Yorum Yönetimi
esa_get_comment- Kimliğine göre belirli bir yorumu alesa_create_comment- Bir gönderiye yeni yorum ekleesa_update_comment- Mevcut bir yorumu güncelleesa_delete_comment- Bir yorumu silesa_get_post_comments- Sayfalama ile belirli bir gönderinin yorumlarını alesa_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 alesa_get_top_categories- Bir takımın tüm üst düzey kategorilerini alesa_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çinmatch: "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 alesa_get_markdown_syntax_help- esa Markdown sözdizimi belgelerini alesa_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
- Şablon:
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 writeveyaadmin:comment read:post write:post read:category read:tag read:attachment read:team read:member - PAT v2 önerilir.
- Gerekli kapsamlar:
- 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/nodedeğeriniwhich nodekomutunun çı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
- esa.io - İş birliğine dayalı dokümantasyon platformu
- Model Context Protocol - MCP hakkında daha fazla bilgi edinin
- API Documentation - esa.io API başvurusu
- Claude Desktop - MCP destekli yapay zekâ asistanı
Destek
- 📧 Destek: Geri Bildirim Formu
- 🐛 Sorunlar: GitHub Issues
- 📖 Yardım: esa Docs
esa ekibi tarafından ❤️ ile hazırlandı