Buildable MCP Server

resmi

Buildable AI destekli geliştirme platformu için resmi MCP sunucusu. Yapay zeka asistanlarının görevleri yönetmesine, ilerlemeyi takip etmesine, proje bağlamını almasına ve yazılım projelerinde insanlarla işbirliği yapmasına olanak tanır.

GitHub

Dokümantasyon

@bldbl/mcp

Buildable için resmi MCP istemcisi - Her projeyi inşa edilebilir kılan yapay zeka destekli geliştirme platformu

Bu paket, yapay zeka asistanlarının (Claude, GPT, vb.) Model Bağlam Protokolü (MCP) kullanarak Buildable projeleriyle doğrudan çalışmasını sağlar. Yapay zeka asistanları proje bağlamını alabilir, görevleri yönetebilir, ilerlemeyi takip edebilir ve insan geliştiricilerle iletişim kurabilir.

🌟 Buildable Nedir?

Buildable (bldbl.dev), her projeyi inşa edilebilir kılan yapay zeka destekli bir geliştirme platformudur. Sağladıkları:

Yapay Zeka ile Oluşturulan İnşa Planları: Uygulama detaylarını içeren kapsamlı proje yol haritaları
Akıllı Görev Yönetimi: Bağımlılıklar ve önceliklerle otomatik görev dağılımı
Yapay Zeka Asistan Entegrasyonu: Claude, GPT ve diğer yapay zeka asistanlarıyla doğrudan entegrasyon
Gerçek Zamanlı İşbirliği: Karmaşık projelerde sorunsuz insan-yapay zeka işbirliği
İlerleme Takibi: Geliştirme ilerlemesinin ve engellerin canlı izlenmesi

🚀 Özellikler

Tam Proje Entegrasyonu: Eksiksiz proje bağlamı, planları ve görev detaylarını alın
Otonom Görev Yönetimi: Görevleri başlatın, ilerlemeyi güncelleyin ve tamamlayın
İnsan İşbirliği: Sorular ve engeller için tartışmalar oluşturun
Gerçek Zamanlı İlerleme Takibi: Canlı güncellemeler ve durum izleme
Tip Güvenli API: Kapsamlı tip tanımlamalarıyla tam TypeScript desteği
Claude Desktop'a Hazır: Sorunsuz Claude Desktop entegrasyonu için CLI arayüzü

📦 Kurulum

Smithery ile Kurulum

Claude Desktop için @bldbl/mcp'yi Smithery aracılığıyla otomatik olarak kurmak için:

npx -y @smithery/cli install @buildable/bldbl-mcp --client claude

Manuel Kurulum

npm install @bldbl/mcp

🚀 Hızlı Başlangıç

Adım 1: MCP Sunucusunu Kurun

npm install -g @bldbl/mcp

Adım 2: Buildable API Anahtarınızı Alın

bldbl.dev adresine gidin ve bir hesap oluşturun
Bir proje oluşturun veya seçin
Proje Ayarları → Yapay Zeka Asistanları → API Anahtarı Oluştur yolunu izleyin

Adım 3: Yapay Zeka Asistanınızı Yapılandırın

🤖 Claude Desktop için:

Bunu Claude Desktop yapılandırma dosyanıza (~/.config/claude/claude_desktop_config.json) ekleyin:

{
  "mcpServers": {
    "buildable": {
      "command": "npx",
      "args": ["-y", "@bldbl/mcp"],
      "env": {
        "BUILDABLE_API_KEY": "bp_your_api_key_here",
        "BUILDABLE_PROJECT_ID": "your-project-id",
        "BUILDABLE_AI_ASSISTANT_ID": "claude-desktop"
      }
    }
  }
}

Minimum kurulum - yalnızca API URL'si otomatik olarak algılanır.

✨ Cursor AI için:

Seçenek 1: Tek Tıkla Kurulum (Önerilen)

bldbl.dev üzerindeki projenize gidin
Entegrasyonlar bölümüne gidin
"Cursor'a Ekle" düğmesine tıklayın - Bitti! 🎉

Seçenek 2: Manuel Yapılandırma Bunu Cursor AI yapılandırma dosyanıza ekleyin:

{
  "mcpServers": {
    "buildable": {
      "command": "npx",
      "args": ["-y", "@bldbl/mcp"],
      "env": {
        "BUILDABLE_API_KEY": "bp_your_api_key_here",
        "BUILDABLE_PROJECT_ID": "your-project-id",
        "BUILDABLE_AI_ASSISTANT_ID": "cursor-ide"
      }
    }
  }
}

Minimum kurulum - yalnızca API URL'si otomatik olarak algılanır.

Adım 4: Yapay Zeka Destekli Geliştirmeye Başlayın!

Yapılandırıldıktan sonra, yapay zeka asistanınız bu güçlü araçlara erişebilir:

🏗️ get_project_context - Tüm proje yapınızı anlayın
📋 get_next_task - Önceliklere göre üzerinde çalışılacak bir sonraki işi bulun
▶️ start_task - Belirli bir görev üzerinde çalışmaya başlayın
📊 update_progress - Detaylı ilerleme güncellemeleri raporlayın
✅ complete_task - Görevleri kapsamlı notlarla tamamlandı olarak işaretleyin
💬 create_discussion - İnsan girdisine ihtiyaç duyduğunuzda sorular sorun
🔍 health_check - Buildable bağlantısını doğrulayın

💡 Örnek Yapay Zeka Konuşması:

You: "What should I work on next in my project?"

AI: *calls get_project_context & get_next_task*
    "I see you're building a React dashboard app. The next 
     high-priority task is 'Implement user authentication'. 
     Should I start working on it?"

You: "Yes, go ahead!"

AI: *calls start_task*
    "Perfect! I'm starting the authentication task. I'll use 
     NextAuth.js with GitHub OAuth. Let me break this down:
     1. Install dependencies
     2. Set up NextAuth config  
     3. Create login/logout components
     4. Add protected routes
     
     I'll update you on progress as I work!"

[AI works and calls update_progress periodically]

AI: *calls update_progress*
    "Progress update: 75% complete! I've implemented:
     ✅ NextAuth.js configuration
     ✅ GitHub OAuth provider setup  
     ✅ Login/logout components
     🔄 Currently working on: Protected route middleware
     
     Should I continue with the remaining work?"

🔧 Gelişmiş Yapılandırma

Ortam Değişkenleri

Doğru yapay zeka asistanı takibi için 3 ortam değişkeni önerilir:

export BUILDABLE_API_KEY="bp_your_api_key_here"           # Your API key (required)
export BUILDABLE_PROJECT_ID="your-project-id"             # Target project (required)
export BUILDABLE_AI_ASSISTANT_ID="my-ai-assistant"        # AI Assistant ID (recommended)

# Optional (has smart default):
# export BUILDABLE_API_URL="https://bldbl.dev/api"        # API endpoint (default)

Yapay Zeka Asistan Kimliği neden önemlidir: Bu, proje panonuzda hangi yapay zeka asistanının hangi işi yaptığını takip etmenize yardımcı olur.

CLI Kullanımı

MCP sunucusunu doğrudan da çalıştırabilirsiniz:

# Install globally and use bldbl command
npm install -g @bldbl/mcp
bldbl

# Or run with npx (no installation needed)
npx @bldbl/mcp

Birden Fazla Proje

Birden fazla Buildable projesiyle çalışmak için farklı MCP sunucu yapılandırmaları oluşturun:

{
  "mcpServers": {
    "buildable-frontend": {
      "command": "npx",
      "args": ["-y", "@bldbl/mcp"],
      "env": {
        "BUILDABLE_API_KEY": "bp_frontend_key_here",
        "BUILDABLE_PROJECT_ID": "frontend-project-id",
        "BUILDABLE_AI_ASSISTANT_ID": "claude-frontend"
      }
    },
    "buildable-backend": {
      "command": "npx", 
      "args": ["-y", "@bldbl/mcp"],
      "env": {
        "BUILDABLE_API_KEY": "bp_backend_key_here",
        "BUILDABLE_PROJECT_ID": "backend-project-id",
        "BUILDABLE_AI_ASSISTANT_ID": "claude-backend"
      }
    }
  }
}

🛠️ API Referansı

BuildPlannerMCPClient

Buildable projeleriyle etkileşim kurmak için ana istemci sınıfı.

Yapıcı Metot

new BuildPlannerMCPClient(config: BuildPlannerConfig, options?: ClientOptions)

Yapılandırma Parametreleri:

apiUrl: Buildable API URL'si (varsayılan: 'https://bldbl.dev/api')
apiKey: Buildable API anahtarınız ('bp_' ile başlar)
projectId: Hedef proje kimliği
aiAssistantId: Yapay zeka asistanınız için benzersiz tanımlayıcı
timeout: Milisaniye cinsinden istek zaman aşımı (varsayılan: 30000)

Seçenekler:

retryAttempts: Yeniden deneme sayısı (varsayılan: 3)
retryDelay: Yeniden denemeler arasındaki ms cinsinden gecikme (varsayılan: 1000)

Metotlar

`getProjectContext(): Promise<ProjectContext>`

Plan, görevler ve son aktivite dahil olmak üzere eksiksiz proje bağlamını alın.

`getNextTask(): Promise<NextTaskResponse>`

Bağımlılıklara ve önceliğe göre üzerinde çalışılacak bir sonraki önerilen görevi alın.

`startTask(taskId: string, options?: StartTaskOptions): Promise<StartTaskResponse>`

İsteğe bağlı yaklaşım ve zamanlama tahminleriyle belirli bir görev üzerinde çalışmaya başlayın.

`updateProgress(taskId: string, progress: ProgressUpdate): Promise<ProgressResponse>`

Detaylı durum bilgisiyle mevcut görevdeki ilerlemeyi güncelleyin.

`completeTask(taskId: string, completion: CompleteTaskRequest): Promise<CompleteTaskResponse>`

Detaylı tamamlama bilgisiyle bir görevi tamamlandı olarak işaretleyin.

`createDiscussion(discussion: CreateDiscussionRequest): Promise<DiscussionResponse>`

Rehberliğe ihtiyaç duyduğunuzda insan girdisi için bir tartışma/soru oluşturun.

`healthCheck(): Promise<{status: string, timestamp: string}>`

Buildable API'sinin bağlantı ve sağlık durumunu kontrol edin.

`disconnect(): Promise<void>`

İstemci bağlantısını düzgün bir şekilde kesin ve temizleyin.

🔐 Kimlik Doğrulama

API Anahtarı Oluşturun: Buildable projenize gidin → Yapay Zeka Asistanı sekmesi → API Anahtarı Oluştur
Güvenli Depolama: API anahtarınızı güvenli bir şekilde saklayın (ortam değişkenleri önerilir)
Anahtar Formatı: API anahtarları bp_ ile başlar, ardından proje ve rastgele tanımlayıcılar gelir

🐛 Hata Yönetimi

İstemci kapsamlı hata yönetimi içerir:

try {
  const context = await client.getProjectContext();
} catch (error) {
  if (error.code === 'UNAUTHORIZED') {
    console.error('Invalid or expired API key');
  } else if (error.code === 'PROJECT_NOT_FOUND') {
    console.error('Project not found or access denied');
  } else {
    console.error('API error:', error.message);
  }
}

🔄 Geliştirme İş Akışı

Buildable ile tipik yapay zeka asistanı iş akışı:

Başlat - API anahtarıyla Buildable'a bağlanın
Bağlamı Al - Proje yapısını ve mevcut durumu anlayın
İş Bul - Bir sonraki öncelikli görevi alın
Görevi Başlat - Yaklaşım ve tahminlerle çalışmaya başlayın
İlerleme Güncellemeleri - Detaylı düzenli ilerleme raporları
Soru Sor - Engeller veya kararlar için tartışmalar oluşturun
Görevi Tamamla - Kapsamlı tamamlama notlarıyla bitirin
Tekrarla - Sonraki görevlerle devam edin

📊 Kullanım İstatistikleri

// Get usage statistics for your AI assistant
const stats = await client.getUsageStats();
console.log(`Tasks completed: ${stats.tasksCompleted}`);
console.log(`Average completion time: ${stats.avgCompletionTime}min`);
console.log(`Success rate: ${stats.successRate}%`);

⚡ CLI Kullanımı

Kurulduktan sonra, CLI'yi birkaç şekilde kullanabilirsiniz:

# Run directly with npx (no installation needed)
npx @bldbl/mcp

# Or install globally and use the bldbl command
npm install -g @bldbl/mcp
bldbl

# For Claude Desktop, use the bldbl command in your config

Gerekli Ortam Değişkenleri:

BUILDABLE_API_URL - Buildable API URL'niz
BUILDABLE_API_KEY - API anahtarınız ('bp_' ile başlar)
BUILDABLE_PROJECT_ID - Hedef proje kimliği
BUILDABLE_AI_ASSISTANT_ID - Benzersiz asistan tanımlayıcısı

🧪 Test

Paket kapsamlı test yardımcı programları içerir:

import { createTestClient } from '@bldbl/mcp/test';

// Create a test client with mock responses
const testClient = createTestClient({
  mockProject: {
    id: 'test-project',
    title: 'Test Project'
  }
});

// Use in your tests
await testClient.startTask('test-task-id');

🔗 Bağlantılar

🌐 Ana Sayfa: bldbl.dev
📚 Dokümantasyon: bldbl.dev/docs
💬 Topluluk: Discord
🐛 Destek: [email protected]
📦 NPM Paketi: npmjs.com/package/@bldbl/mcp

🏗️ Kullanılan Teknolojiler

TypeScript - Tip güvenli geliştirme
Model Bağlam Protokolü (MCP) - Standartlaştırılmış yapay zeka asistanı iletişimi
Node.js - Çalışma zamanı ortamı
REST API - Basit ve güvenilir iletişim

📄 Lisans

Bu yazılım özel mülkiyete tabidir ve gizlidir. İzinsiz kopyalama, dağıtma veya kullanım kesinlikle yasaktır.

Buildable ekibi tarafından ❤️ ile yapıldı

Buildable, ticari bir yapay zeka destekli geliştirme platformudur. Başlamak için bldbl.dev adresini ziyaret edin.

🆘 Destek

Dokümantasyon: https://bldbl.dev/docs
E-posta: [email protected]
Web Sitesi: https://bldbl.dev

BuildPlanner ekibi tarafından ❤️ ile inşa edildi