📓 GistPad MCP

Kişisel bilginizi, günlük notlarınızı ve yeniden kullanılabilir promptlarınızı GitHub Gists aracılığıyla yönetmek ve paylaşmak için bir MCP sunucusu. GistPad VS Code extension ve GistPad.dev (web/mobil için) uygulamasının bir tamamlayıcısıdır. Herhangi bir MCP özellikli yapay zeka ürününden (örn. GitHub Copilot, Claude Desktop) gistlerinize erişmenize ve düzenlemenize olanak sağlar.

• 🏃 Başlarken
• 🛠️ Dahil edilen araçlar
• 📁 Dahil edilen kaynaklar
• 💬 Yeniden kullanılabilir promptlar
• 💻 CLI referansı

🏃 Başlarken

1. VS Code kullanıyor musunuz?

   1. GistPad extension'i yükleyin ve ardından VS Code'u yeniden yükleyin

      Not: Bu, VS Code 1.101.0+ gerektirir, eski bir sürümdeysseniz güncelleme zamanı gelmiştir!

   2. GistPad sekmesini açın ve GitHub hesabınızla oturum açın. Bundan sonra, ek kurulum veya token yönetimi yapmadan Copilot chat'ten (Agent modunda) GistPad'i kullanmaya başlayabilirsiniz 💪

2. Diğer MCP istemcileri...

   1. Yalnızca gist kapsamını içeren bir personal access token oluşturun: https://github.com/settings/tokens/new

   2. Aşağıdakine eşdeğer bir şeyi istemcinizin MCP config dosyasına ekleyin (veya "MCP sunucusu ekle" GUI/TUI aracılığıyla):

      {
        "mcpServers": {
          "gistpad": {
            "command": "npx",
            "args": ["-y", "gistpad-mcp"],
            "env": {
              "GITHUB_TOKEN": "<YOUR_PAT>"
            }
          }
        }
      }
      

İstemciniz kurulduktan sonra, gistler + MCP ile eğlenmeye başlayabilirsiniz! 🥳 Örneğin, aşağıdaki gibi şeyleri deneyin...

1. İçeriği keşfetme

   • Bu ay kaç gist düzenledim?
   • Benim <foo> gistimin özeti nedir?

2. İçerik oluşturma

   • <foo> hakkında yeni bir gist oluştur
   • Benim <foo> gistimi <bar>'ı vurgulayacak şekilde güncelle

3. Günlük yapılacaklar

   • Bugün benim tamamlanmamış yapılacaklarım nelerdir?
   • <foo> için yeni bir yapılacak ekle

4. İşbirliği

   • <foo> gistine <bar> diyerek bir yorum ekle
   • Bana <foo> gistinin paylaşım URL'sini ver
   • Yıldızlanmış gistlerimi göster

5. Gist organizasyonu

   • <foo> hakkındaki gistimi arşivle
   • <bar> gistine yeni bir <foo> dosyası ekle ve <baz> içeriğini buna geçir

6. Yeniden kullanılabilir promptlar

   • Belirtilen bir manga serisini web'de arayan ve ardından bunun hakkında bir özet sağlayan yeni bir prompt oluştur
   • <foo> hakkındaki promptumu sil

🛠️ Dahil edilen araçlar

Gist yönetimi

• list_gists - Tüm gistlerinizi listeleyin (günlük notları ve arşivlenmiş gistleri hariç).
• get_gist - Bir gistinizin içeriğini ID'ye göre alın.
• create_gist - Belirtilen açıklama ve başlangıç dosya içeriğiyle yeni bir gist oluşturun.
• delete_gist - Bir gisti ID'ye göre silin.
• update_gist_description - Bir gistin açıklamasını ID'ye göre güncelleyin.
• duplicate_gist - Tüm dosyalarıyla birlikte mevcut bir gistin bir kopyasını oluşturun.
• refresh_gists - Gist listelerinizi yeniden yükleyin ve önbelleğe alınan verileri yoksayın.

Dosya yönetimi

• update_gist_file - Bir gist içindeki belirli bir dosyanın içeriğini güncelleyin.
• add_gist_file - Mevcut bir giste yeni bir dosya ekleyin.
• delete_gist_file - Bir gist'ten dosya silin.
• rename_gist_file - Bir gist içindeki mevcut bir dosyayı yeniden adlandırın.
• edit_gist_file - Bir gist dosyasına hedefli bulma ve değiştirme düzenlemeleri yapın.

Yorumlar

• list_gist_comments - Belirtilen bir gist için tüm yorumları listeleyin.
• add_gist_comment - Bir giste yeni bir yorum ekleyin.
• edit_gist_comment - Mevcut bir yorumun içeriğini güncelleyin.
• delete_gist_comment - Bir gist'ten yorum silin.

🛠️ İsteğe bağlı araçlar

Aşağıdaki araç setleri, araç yüzeyini minimal tutmak için varsayılan olarak devre dışı bırakılmıştır. Bunları karşılık gelen CLI bayrağını geçirerek etkinleştirin.

Günlük notlar (--daily)

• get_todays_note - Bugünün günlük notunu alın veya oluşturun.
• update_todays_note - Bugünün günlük notunun içeriğini güncelleyin.
• list_daily_notes - Tüm günlük notlarınızı listeleyin.
• get_daily_note - Belirtilen tarihe göre belirli bir günlük notun içeriğini alın.
• delete_daily_note - Belirtilen tarihe göre belirli bir günlük notu silin.

Yıldızlama (--starred)

• list_starred_gists - Tüm yıldızlanmış gistlerinizi listeleyin.
• star_gist - Belirtilen bir gisti ID'ye göre yıldızlayın.
• unstar_gist - Yıldızlanmış bir gisti yıldızdan çıkarın.

Arşivleme (--archived)

• list_archived_gists - Tüm arşivlenmiş gistlerinizi listeleyin.
• archive_gist - Gistlerinizin birini arşivleyin.
• unarchive_gist - Arşivlenmiş bir gisti arşivden çıkarın.

Promptlar (--prompts)

• list_gist_prompts - Prompts koleksiyonunuzdaki promptları listeleyin.
• add_gist_prompt - Prompts koleksiyonunuza yeni bir prompt ekleyin.
• delete_gist_prompt - Koleksiyonunuzdan bir promptu silin.

📁 Dahil edilen kaynaklar

Yukarıdaki araçlara ek olarak, GistPad MCP sunucusu ayrıca gistlerinizi kaynaklar olarak ortaya çıkarır (gist:/// URI şemasını kullanarak). Bu, istemcilerin bunları araç yürütmesi gerekmeden okumasına olanak sağlar.

Bir gist eklediğinizde/sildiğinizde/çoğalttığınızda veya gistin açıklamasını değiştirdiğinizde, MCP istemcilerine kaynak listesinin değiştiğini belirten bir bildirim sağlanacaktır. MCP istemciniz kaynak aboneliklerini destekliyorsa, belirli bir giste abone olabilir ve güncellendiğinde bildirim alabilirsiniz.

Ek olarak, MCP istemcileriniz kaynak şablonlarını destekleyen istemciler için, GistPad ayrıca gist:///{gistId}/comments adresinde bir kaynak ortaya çıkarır. Bu, list_gist_comments aracını yürütme gerekmeden bir gistin yorumlarını sorgulamaya olanak sağlar.

Kaynak konfigürasyonu

Arşivlenmiş gistlerinizi, yıldızlanmış gistlerinizi ve/veya günlük notlarınızı kaynaklar olarak ortaya çıkarmak istiyorsanız, MCP sunucusu konfigürasyonunuzu gistpad-mcp CLI'sine --archived, --starred ve/veya --daily bayraklarını geçecek şekilde güncelleyin.

💬 Yeniden kullanılabilir promptlar

GistPad, bir gist içinde markdown dosyaları olarak saklanan parametreleştirilmiş/yeniden kullanılabilir promptlar oluşturmanıza ve yönetmenize olanak sağlar. add_prompt ve delete_prompt aracını kullanarak, MCP istemcinizden belirtilen içerik/argümanlar ile bir prompt oluşturmasını/silmesini isteyerek promptları yönetebilirsiniz.

Perde arkasında, promptlar 💬 Prompts adlı bir gist içinde markdown dosyaları olarak depolanır (bu, add_prompt aracı tarafından otomatik olarak oluşturulur). Prompt dosyaları, prompt'ı gövde olarak ve isteğe bağlı olarak ön madde kullanarak açıklamalar ve argümanlar içerir. Prompt argümanlar kullanıyorsa, promptun gövdesi {{argument}} yer tutuçlarını içermelidir. Bu, MCP istemcisi bunu aldığında değiştirilecektir.

💻 CLI Referansı

gistpad-mcp CLI aşağıdaki isteğe bağlı bayrakları kabul eder:

• --archived - Arşiv araçlarını etkinleştirin ve arşivlenmiş gistleri kaynaklara dahil edin
• --starred - Yıldızlama araçlarını etkinleştirin ve yıldızlanmış gistleri kaynaklara dahil edin
• --daily - Günlük not araçlarını etkinleştirin ve günlük notları kaynaklara dahil edin
• --prompts - Prompt araçlarını ve MCP prompt işleyicilerini etkinleştirin
• --markdown - Gistleri yalnızca Markdown dosyalarından oluşturulanlarla filtrelenin

🧰 Sorun giderme

• Listenizde bir gist görmüyor musunuz? GistPad MCP sunucusu gist listenizi önbelleğe alır ve 1) MCP sunucusu aracılığıyla herhangi bir değişiklik yaptığınızda veya 2) her saat günceller. Ancak, bir gisti harici bir istemci kullanarak ekler/düzenler/silerseniz, GistPad MCP'nin kendisini yenilemesini söylemeniz gerekebilir (saatlik yenilemesini henüz gerçekleştirmediyse). Bunu refresh_gists aracını tetikleyerek yapabilirsiniz (örn. VS Code Copilot chat'te #refresh_gists komutunu çalıştırarak).