Vibe Check MCP

Bu proje artık aktif olarak bakım görmemektedir. v2.8.0 son sürüm olup, güvenlik yamaları ve hata düzeltmeleri içermektedir. Sunucu tam olarak işlevseldir. MIT lisansı altında topluluk forklama ve katkıları hoşlanıyor.

Aşırı heyecanlı ajanlardan hoşça kalın. Tak ve oyna ajan gözetim aracı.

Araştırmaya dayanmaktadır:
Çalışmamızda Vibe Check çağıran ajanlar başarıyı +%27 artırdı ve zararlı eylemleri -%41 azalttı

_{PulseMCP'de Öne Çıkartılan "En Popüler (Bu Hafta)" • Smithery.ai'de 5000+ aylık çağrı • araştırma destekli gözetim • STDIO + akışlı HTTP taşıması}

Ajanları aşırı mühendisliğe karşı koruyan ve onları minimum uygulanabilir yola saklayan tak ve oyna mentor katmanı — LLM'leri hizalı, yansıtıcı ve güvenli tutan araştırma destekli MCP sunucusu.

MCP platformları ve registryleri genelinde geliştirici tarafından güveniliyor

Hızlı Başlangıç (npx)

Sunucuyu yerel kurulum olmadan npm'den doğrudan çalıştırın. Node >=20 gereklidir. Bir taşıma seçin:

Seçenek 1 – MCP istemcisi STDIO üzerinden

npx -y @pv-bhat/vibe-check-mcp start --stdio

MCP farkında bir istemciden başlatın (Claude Desktop, Cursor, Windsurf, vb.).
[MCP] stdio transport connected işlem istemciyi beklemede olduğunu gösterir.
Komutu oluşturması için bu bloğu istemci yapılandırmanıza ekleyin:

{
  "mcpServers": {
    "vibe-check-mcp": {
      "command": "npx",
      "args": ["-y", "@pv-bhat/vibe-check-mcp", "start", "--stdio"]
    }
  }
}

Seçenek 2 – Manuel HTTP incelemesi

npx -y @pv-bhat/vibe-check-mcp start --http --port 2091

Hizmeti canlı doğrulamak için curl http://127.0.0.1:2091/health kullanın.
JSON-RPC isteklerini http://127.0.0.1:2091/rpc adresine gönderin.

npx her iki seçenek için paketi isteğe bağlı olarak indirir. Ayrıntılı istemci kurulumu ve install ve doctor gibi diğer komutlar için aşağıdaki belgelendirmeye bakın.

Tanıma

PulseMCP "En Popüler (Bu Hafta)" ön sayfasında öne çıkartıldı (13 Ekim 2025 haftası) 🔗
Anthropic'in resmi Model Context Protocol deposunda listelendi 🔗
Resmi MCP Registry'de bulunabilir 🔗
Sean Kochel'in En İyi 9 MCP sunucusunun vibe kodcuları için öne çıkartıldığında 🔗

İçindekiler

Hızlı Başlangıç (npx)
Vibe Check MCP Nedir?
Genel Bakış
Sorun: Desen İnertiası ve Muhakeme Kilitlenmesi
Temel Özellikler
Yenilenen Nedir
Geliştirme Kurulumu
Yayın
Kullanım Örnekleri
Uyarlanabilir Metabilişsel Kesintiler (CPI)
Ajan İstemi Gereklilikleri
Her Aracı Ne Zaman Kullanacağınız
Belgelendirme
Araştırma ve Felsefe
Güvenlik
Yol Haritası
Katkıda Bulunanlar ve Topluluk
SSS
Şurada Listelendi
Teşekkür ve Lisans

Vibe Check MCP Nedir?

Vibe Check MCP, ajanları minimum uygulanabilir yola tutarak ve karmaşıklığı sadece kanıt gerektirdiğinde yükselterek gözetim sağlar. Vibe Check MCP, Anthropic'in Model Context Protocol uygulaması yapan hafif bir sunucudur. Ajanlarınız için bir AI meta-mentor olarak hareket eder, Chain-Pattern Interrupts (CPI) ile desen inertiasına müdahale ederek Reasoning Lock-In (RLI) önler. Bunu LLM'ler için kauçuk ördek hata ayıklayıcı olarak düşünün – ajanınız yanlış yola gitmeden önce hızlı bir akıl sağlığı kontrolü.

Genel Bakış

Vibe Check MCP, metabilişsel bir sinyal katmanını CPI ile birleştirerek ajanlar risk arttığında duraklamasını sağlar. Vibe Check özellikleri, belirsizliği ve risk puanlarını ortaya koymaktadır; CPI bu tetikleyicileri tüketir ve ajan devam etmeden önce bir müdahale politikasını uygular. CPI entegrasyon kılavuzuna ve https://github.com/PV-Bhat/cpi adresindeki CPI deposuna bakın.

Vibe Check, ana ajanınıza meta-bilişsel geri bildirim sağlamak için ikinci bir LLM çağırır. vibe_check çağrılarını ajan sistem istelerine entegre etmek ve geri dönüşsüz eylemlerden önce tool çağrılarını talimatlandırmak ajan hizalamasını ve sağduyusunu önemli ölçüde iyileştirir. Yüksek seviye bileşen haritası: docs/architecture.md, CPI teslimat diyagramı ve örnek değirmeni docs/integrations/cpi.md adresinde yakalaşmıştır.

Sorun: Desen İnertiası ve Muhakeme Kilitlenmesi

Büyük dil modelleri hatalı planları güvenle takip edebilir. Harici bir itme olmadan aşırı mühendislik veya yanlış hizalamaya spiral çekilebilirler. Vibe Check bu itmeyi kısa yansıtıcı duraklamalar yoluyla sağlayarak güvenilirlik ve güvenliği iyileştirir.

Temel Özellikler

Özellik	Açıklama	Faydalar
CPI Uyarlanabilir Kesintiler	Risk farkında istemler varsayımları sorgulamaz	hizalama, sağlamlık
Çok Sağlayıcı LLM	Gemini, OpenAI, Anthropic ve OpenRouter desteği	esneklik
Geçmiş Sürekliliği	`sessionId` sağlandığında önceki tavsiyeyi özetler	bağlam saklama
İsteğe Bağlı vibe_learn	Hatalar ve düzeltmeleri gelecekteki yansıtma için kaydetme	kendi kendini geliştirme

Yenilenen Nedir v2.8.0 (Final Maintenance Release)

Bakım Bildirimi: Bu proje artık aktif olarak bakım görmemektedir. MIT lisansı altında tam olarak işlevseldir ve kullanılabilirdir. Topluluk forklama hoşlanıyor. Ayrıntılar için bkz. Changelog.

Hata düzeltmesi: check_constitution artık geçerli MCP içerik türleri döndürüyor (#84'ü düzeltir)
Güvenlik: Tüm bağımlılıklar güncellendi — 14 npm denetimi güvenlik açığını çözüyor (axios, MCP SDK, diff, express ve geçişli bağımlılıklar)
MCP SDK 1.26: Kritik çapraz istemci veri sızması düzeltmesi ile en son SDK'ya güncellendi; HTTP taşıma adaptörü uyumluluk için güncellendi

Oturum Anayasası (oturum başına kurallar)

CPI'nin onayacağı sessionId başına kuralları uygulamak için hafif bir "anayasa" kullanın. Örneğin anayasa kuralları: "dış ağ çağrıları yok," "refactorlardan önce unit testleri tercih et," "hiçbir zaman sırları diske yazma."

API (araçlar):

update_constitution({ sessionId, rules }) → oturum için kural setini birleştirir/ayarlar
reset_constitution({ sessionId }) → oturum kurallarını temizler
check_constitution({ sessionId }) → oturum için etkili kuralları döndürür

Geliştirme Kurulumu

# Klonlama ve kurulum
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server
npm ci
npm run build
npm test

Tüm iş akışları için npm kullanın (npm ci, npm run build, npm test). Bu proje Node >=20 hedefi alır.

Kullanmayı planladığınız API anahtarları ile .env dosyası oluşturun:

# Gemini (varsayılan)
GEMINI_API_KEY=your_gemini_api_key
# İsteğe bağlı sağlayıcılar / Anthropic uyumlu uç noktalar
OPENAI_API_KEY=your_openai_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
ANTHROPIC_AUTH_TOKEN=your_proxy_bearer_token
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_VERSION=2023-06-01
# İsteğe bağlı geçersiz kılmalar
# DEFAULT_LLM_PROVIDER gemini | openai | openrouter | anthropic kabul eder
DEFAULT_LLM_PROVIDER=gemini
DEFAULT_MODEL=gemini-2.5-pro

Yapılandırma

Testleri çalıştırma talimatları için docs/TESTING.md adresine bakın.

Docker

Depo, tek komut kurulum için bir yardımcı komut dosyası içerir.

bash scripts/docker-setup.sh

Tam ayrıntılar için Otomatik Docker Kurulumu adresine bakın.

Sağlayıcı anahtarları

Desteklenen sağlayıcılar, çözüm sırası, depolama konumları ve güvenlik rehberliği için API Anahtarları ve Gizli Yönetimi adresine bakın.

Taşıma seçimi

CLI stdio ve HTTP taşımalarını destekler. Taşıma çözümü bu sıra izler: açık bayraklar (--stdio/--http) → MCP_TRANSPORT → varsayılan stdio. HTTP kullanırken --port (veya MCP_HTTP_PORT ayarla); varsayılan bağlantı noktası 2091'dir. Oluşturulan girişler --stdio veya --http --port <n> ekler ve HTTP-kapasiteli istemciler de http://127.0.0.1:<port> bitiş noktası alırlar.

İstemci yükleyicileri

Her yükleyici idempotent ve girişleri "managedBy": "vibe-check-mcp-cli" ile etiketler. Yedeklemeler değişiklikler uygulanmadan önce çalıştırma başına bir kez yazılır ve birleşmeler atomiktir (*.bak dosyaları geri alma kolaylaştırır). Daha derin istemci özel referanslar için docs/clients.md adresine bakın.

Claude Desktop

Yapılandırma yolu: claude_desktop_config.json (platform başına otomatik keşfedilir).
Varsayılan taşıma: stdio (npx … start --stdio).
Yeni MCP sunucusunu yüklemek için Claude Desktop'ı yeniden başlatın.
vibe-check-mcp için yönetilmeyen bir giriş zaten varsa, CLI bunu dokunmadan bırakır ve bir uyarı yazdırır.

Cursor

Yapılandırma yolu: ~/.cursor/mcp.json (farklı depoladığınız takdirde --config sağlayın).
Şema Claude'un mcpServers düzenini yansıtır.
Dosya eksikse, CLI başarısız olmak yerine Cursor ayarları paneli için hazır-yapıştır JSON bloğu yazdırır.

Windsurf (Cascade)

Yapılandırma yolu: eski ~/.codeium/windsurf/mcp_config.json, yeni yapılar ~/.codeium/mcp_config.json kullanır.
Windsurf'un HTTP istemcisi için serverUrl ile giriş yayınlamak için --http geçer.
Mevcut sentinel yönetilen serverUrl girişleri yerinde korunur ve güncellenir.

Visual Studio Code

Çalışma alanı yapılandırması .vscode/mcp.json adresinde yaşar; profiller ayrıca VS Code kullanıcı veri dizininizde mcp.json depolar.
Çalışma alanı dosyasını hedeflemek için --config <path> sağlayın. --config olmadan CLI bir JSON parçacığı ve terminalden doğrudan açabileceğiniz vscode:mcp/install?... bağlantısı yazdırır.
VS Code isteğe bağlı dev alanlarını destekler; dev.watch/dev.debug doldurmak için --dev-watch ve/veya --dev-debug <value> geçer.

Kaldırma ve geri alma

Yapılandırmanın yanında oluşturulan yedeklemeleri geri yükleyin (en yeni *.bak) hemen geri almak için.
Sunucuyu manuel olarak kaldırmak için, yapılandırmanız vibe-check-mcp girişini silin (Claude/Windsurf/Cursor altında mcpServers veya VS Code'da servers) hala "managedBy": "vibe-check-mcp-cli" ile etiketlendikçe.

Araştırma ve Felsefe

CPI (Chain-Pattern Interrupt) Vibe Check'in arkasındaki araştırma destekli gözetim yöntemidir. Risk enfleksiyon anlarında ajan yeniden taşmayı durdurmak ve kullanıcının gerçek önceliğine yeniden hizalamak için kısa, iyi zamanlanmış "duraklatma noktaları" enjekte eder, yıkıcı kaskaları ve muhakeme kilitlenmesini (RLI) önler. 153 çalıştırma arasında havuzlanmış değerlendirmede, CPI başarıyı neredeyse iki katına çıkartır (~%27→54%) ve zararlı eylemleri kabaca yarıya indirir (~%83→42%). En uygun kesinti dozu ~%10–20% adımdır. Vibe Check MCP CPI'yı test zamanında harici bir mentor katmanı olarak uygular.

Bağlantılar:

📄 CPI Makalesi (ResearchGate) — http://dx.doi.org/10.13140/RG.2.2.18237.93922
📘 CPI Referans Uygulaması (GitHub): https://github.com/PV-Bhat/cpi
📚 MURST Zenodo DOI (RSRC arşiv): https://doi.org/10.5281/zenodo.14851363

flowchart TD
  A[Agent Phase] --> B{Monitor Progress}
  B -- high risk --> C[CPI Interrupt]
  C --> D[Reflect & Adjust]
  B -- smooth --> E[Continue]

Ajan İstemi Gereklilikleri

Ajanınızın sistem isteminde, vibe_check yansıtma için zorunlu bir araç olduğunu açıkça belirtin. Her zaman tam kullanıcı isteğini ve diğer ilgili bağlamı geçin. Bir hatayı düzelttikten sonra, isteğe bağlı olarak gelecekteki analiz için tarih oluşturmak üzere vibe_learn ile kaydedin.

Örnek parçacık:

Özerk ajan olarak şunları yapacaksınız:
1. Planlamadan sonra ve büyük eylemlerden önce vibe_check'i çağırın.
2. Tam kullanıcı isteğini ve mevcut planınızı sağlayın.
3. İsteğe bağlı olarak, çözümlenen sorunları vibe_learn ile kaydedin.

Her Aracı Ne Zaman Kullanacağınız

Araç	Amaç
🛑 vibe_check	Varsayımları sorgulamak ve tünel vizyonunu önlemek
🔄 vibe_learn	Hatalar, tercihler ve başarıları yakalamak
🧰 update_constitution	CPI katmanının uygulanacağı oturum kurallarını ayarlamak/birleştirmek
🧹 reset_constitution	Oturum için kuralları temizlemek
🔎 check_constitution	Oturum için etkili kuralları incelemek

Belgelendirme

Güvenlik

Bu depo, her çekme isteğinde çalışan CI tabanlı güvenlik taraması içerir. npm audit ile bağımlılıkları kontrol eder ve kaynağı riskli desenler için tarar. Ayrıntılar ve sorunları bildirme hakkında bilgi için SECURITY.md adresine bakın.

Yol Haritası

Not: Bu proje son bakım sürümüne (v2.8.0) ulaşmıştır. Aşağıda yer alan yol haritası, geliştirmeyi devam ettirmek isteyebilecek topluluk forklama için korunmuştur.

vibe_check için yapılandırılmış çıktı: { advice, riskScore, traits } gibi JSON zarfı döndürün, böylece akış aşağısı ajanlar belirleyici olarak akıl yürütebilirler.
LLM dayanıklılığı: generateResponse ile yeniden deneme ve üstel geri alma sarmalayın.
Giriş temizleme: Prompt enjeksyon vektörlerini azaltmak için araç bağımsız değişkenlerini doğrulayın ve temizleyin.
İstem dışsallaştırması: Sabit kodlanmış istekleri şeffaflık ve denetlenebilirlik için yapılandırma dosyalarına taşıyın (bkz. PR #71).

Katkıda Bulunanlar ve Topluluk

Katkılar hoşlanıyor! Bkz. CONTRIBUTING.md.

Bağlantılar

Teşekkür ve Lisans

Vibe Check MCP MIT Lisansı altında yayınlanmıştır. Güvenilir, kurumsal düzey AI ajanları için oluşturulmuştur.

Yazar Teşekkürleri ve Bağlantıları

Vibe Check MCP oluşturan: Pruthvi Bhat, Initiative - https://murst.org/

PV-Bhat/vibe-check-mcp-server

Bu MCP sunucusu hakkında