Buildable MCP Server

resmi

Server MCP resmi untuk platform pengembangan bertenaga AI Buildable. Memungkinkan asisten AI untuk mengelola tugas, melacak kemajuan, mendapatkan konteks proyek, dan berkolaborasi dengan manusia dalam proyek perangkat lunak.

GitHub
12

Dokumentasi

@bldbl/mcp

Klien MCP resmi untuk Buildable - Platform pengembangan bertenaga AI yang membuat proyek apa pun dapat dibangun

@bldbl/mcp MCP server

npm version License: MIT smithery badge

Paket ini memungkinkan asisten AI (Claude, GPT, dll.) untuk bekerja langsung dengan proyek Buildable menggunakan Model Context Protocol (MCP). Asisten AI dapat memperoleh konteks proyek, mengelola tugas, melacak kemajuan, dan berkomunikasi dengan pengembang manusia.

🌟 Apa itu Buildable?

Buildable (bldbl.dev) adalah platform pengembangan bertenaga AI yang membuat proyek apa pun dapat dibangun. Platform ini menyediakan:

  • Rencana Pembangunan yang Dihasilkan AI: Peta jalan proyek komprehensif dengan detail implementasi
  • Manajemen Tugas Cerdas: Pemecahan tugas otomatis dengan dependensi dan prioritas
  • Integrasi Asisten AI: Integrasi langsung dengan Claude, GPT, dan asisten AI lainnya
  • Kolaborasi Waktu Nyata: Kolaborasi manusia-AI yang mulus pada proyek kompleks
  • Pelacakan Kemajuan: Pemantauan langsung kemajuan pengembangan dan hambatan

🚀 Fitur

  • Integrasi Proyek Penuh: Dapatkan konteks proyek lengkap, rencana, dan detail tugas
  • Manajemen Tugas Otonom: Mulai, perbarui kemajuan, dan selesaikan tugas
  • Kolaborasi Manusia: Buat diskusi untuk pertanyaan dan hambatan
  • Pelacakan Kemajuan Waktu Nyata: Pembaruan langsung dan pemantauan status
  • API Tipe-Aman: Dukungan TypeScript penuh dengan definisi tipe yang komprehensif
  • Siap untuk Claude Desktop: Antarmuka CLI untuk integrasi Claude Desktop yang mulus

📦 Instalasi

Menginstal melalui Smithery

Untuk menginstal @bldbl/mcp untuk Claude Desktop secara otomatis melalui Smithery:

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

Instalasi Manual

npm install @bldbl/mcp

🚀 Mulai Cepat

Langkah 1: Instal Server MCP

npm install -g @bldbl/mcp

Langkah 2: Dapatkan Kunci API Buildable Anda

  1. Buka bldbl.dev dan buat akun
  2. Buat atau pilih proyek
  3. Buka Pengaturan Proyek → Asisten AI → Hasilkan Kunci API

Langkah 3: Konfigurasikan Asisten AI Anda

🤖 Untuk Claude Desktop:

Tambahkan ini ke file konfigurasi Claude Desktop Anda (~/.config/claude/claude_desktop_config.json):

{
  "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"
      }
    }
  }
}

Pengaturan minimal - hanya URL API yang terdeteksi otomatis.

✨ Untuk Cursor AI:

Opsi 1: Pengaturan Satu Klik (Direkomendasikan)

  1. Buka proyek Anda di bldbl.dev
  2. Arahkan ke Integrasi
  3. Klik "Tambahkan ke Cursor" - Selesai! 🎉

Opsi 2: Konfigurasi Manual Tambahkan ini ke file konfigurasi Cursor AI Anda:

{
  "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"
      }
    }
  }
}

Pengaturan minimal - hanya URL API yang terdeteksi otomatis.

Langkah 4: Mulai Pengembangan Bertenaga AI!

Setelah dikonfigurasi, asisten AI Anda memiliki akses ke alat-alat canggih ini:

  • 🏗️ get_project_context - Pahami seluruh struktur proyek Anda
  • 📋 get_next_task - Temukan apa yang harus dikerjakan selanjutnya berdasarkan prioritas
  • ▶️ start_task - Mulai mengerjakan tugas tertentu
  • 📊 update_progress - Laporkan pembaruan kemajuan terperinci
  • ✅ complete_task - Tandai tugas selesai dengan catatan komprehensif
  • 💬 create_discussion - Ajukan pertanyaan saat Anda membutuhkan masukan manusia
  • 🔍 health_check - Verifikasi koneksi ke Buildable

💡 Contoh Percakapan AI:

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?"

🔧 Konfigurasi Lanjutan

Variabel Lingkungan

3 variabel lingkungan direkomendasikan untuk pelacakan asisten AI yang tepat:

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)

Mengapa ID Asisten AI penting: Ini membantu Anda melacak asisten AI mana yang melakukan pekerjaan apa di dasbor proyek Anda.

Penggunaan CLI

Anda juga dapat menjalankan server MCP secara langsung:

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

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

Beberapa Proyek

Untuk bekerja dengan beberapa proyek Buildable, buat konfigurasi server MCP yang berbeda:

{
  "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"
      }
    }
  }
}

🛠️ Referensi API

BuildPlannerMCPClient

Kelas klien utama untuk berinteraksi dengan proyek Buildable.

Konstruktor

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

Parameter Konfigurasi:

  • apiUrl: URL API Buildable (default: 'https://bldbl.dev/api')
  • apiKey: Kunci API Buildable Anda (dimulai dengan 'bp_')
  • projectId: ID proyek target
  • aiAssistantId: Pengidentifikasi unik untuk asisten AI Anda
  • timeout: Batas waktu permintaan dalam milidetik (default: 30000)

Opsi:

  • retryAttempts: Jumlah percobaan ulang (default: 3)
  • retryDelay: Jeda antar percobaan ulang dalam ms (default: 1000)

Metode

getProjectContext(): Promise<ProjectContext>

Dapatkan konteks proyek lengkap termasuk rencana, tugas, dan aktivitas terbaru.

getNextTask(): Promise<NextTaskResponse>

Dapatkan tugas yang direkomendasikan berikutnya untuk dikerjakan berdasarkan dependensi dan prioritas.

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

Mulai mengerjakan tugas tertentu dengan pendekatan opsional dan perkiraan waktu.

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

Perbarui kemajuan pada tugas saat ini dengan informasi status terperinci.

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

Tandai tugas sebagai selesai dengan informasi penyelesaian terperinci.

createDiscussion(discussion: CreateDiscussionRequest): Promise<DiscussionResponse>

Buat diskusi/pertanyaan untuk masukan manusia saat Anda membutuhkan panduan.

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

Periksa konektivitas dan kesehatan API Buildable.

disconnect(): Promise<void>

Putuskan koneksi dan bersihkan koneksi klien dengan benar.

🔐 Autentikasi

  1. Hasilkan Kunci API: Buka proyek Buildable Anda → tab Asisten AI → Hasilkan Kunci API
  2. Penyimpanan Aman: Simpan kunci API Anda dengan aman (variabel lingkungan direkomendasikan)
  3. Format Kunci: Kunci API dimulai dengan bp_ diikuti oleh pengidentifikasi proyek dan acak

🐛 Penanganan Kesalahan

Klien menyertakan penanganan kesalahan yang komprehensif:

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);
  }
}

🔄 Alur Kerja Pengembangan

Alur kerja asisten AI yang umum dengan Buildable:

  1. Inisialisasi - Hubungkan ke Buildable dengan kunci API
  2. Dapatkan Konteks - Pahami struktur proyek dan keadaan saat ini
  3. Temukan Pekerjaan - Dapatkan tugas prioritas berikutnya
  4. Mulai Tugas - Mulai bekerja dengan pendekatan dan perkiraan
  5. Pembaruan Kemajuan - Laporan kemajuan rutin dengan detail
  6. Ajukan Pertanyaan - Buat diskusi untuk hambatan atau keputusan
  7. Selesaikan Tugas - Selesaikan dengan catatan penyelesaian komprehensif
  8. Ulangi - Lanjutkan dengan tugas berikutnya

📊 Statistik Penggunaan

// 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}%`);

⚡ Penggunaan CLI

Setelah terinstal, Anda dapat menggunakan CLI dengan beberapa cara:

# 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

Variabel Lingkungan yang Diperlukan:

  • BUILDABLE_API_URL - URL API Buildable Anda
  • BUILDABLE_API_KEY - Kunci API Anda (dimulai dengan 'bp_')
  • BUILDABLE_PROJECT_ID - ID proyek target
  • BUILDABLE_AI_ASSISTANT_ID - Pengidentifikasi asisten unik

🧪 Pengujian

Paket ini menyertakan utilitas pengujian yang komprehensif:

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');

🔗 Tautan

🏗️ Dibangun Dengan

  • TypeScript - Pengembangan tipe-aman
  • Model Context Protocol (MCP) - Komunikasi asisten AI terstandarisasi
  • Node.js - Lingkungan runtime
  • REST API - Komunikasi yang sederhana dan andal

📄 Lisensi

Hak Cipta © 2025 Tim Buildable. Semua hak dilindungi undang-undang.

Perangkat lunak ini bersifat proprietary dan rahasia. Penyalinan, distribusi, atau penggunaan yang tidak sah sangat dilarang.

Dibuat dengan ❤️ oleh tim Buildable

Buildable adalah platform pengembangan bertenaga AI komersial. Kunjungi bldbl.dev untuk memulai.

🆘 Dukungan

Dibangun dengan ❤️ oleh tim BuildPlanner