Buildable

आधिकारिक

Buildable AI-संचालित विकास प्लेटफॉर्म के लिए आधिकारिक MCP सर्वर। AI सहायकों को कार्य प्रबंधित करने, प्रगति ट्रैक करने, प्रोजेक्ट संदर्भ प्राप्त करने और सॉफ्टवेयर प्रोजेक्ट्स पर मनुष्यों के साथ सहयोग करने में सक्षम बनाता है।

GitHub

Buildable MCP के साथ आप क्या कर सकते हैं?

पूरा प्रोजेक्ट संदर्भ प्राप्त करें — get_project_context के साथ प्रोजेक्ट योजना, कार्य और हाल की गतिविधि प्राप्त करें।
अगला प्राथमिकता वाला कार्य खोजें — AI से get_next_task को कॉल करने के लिए कहें ताकि निर्भरताओं और प्राथमिकता के आधार पर काम करने के लिए पहचाना जा सके।
कार्य शुरू करें और ट्रैक करें — start_task के माध्यम से किसी विशिष्ट कार्य पर काम शुरू करें और update_progress के साथ क्रमिक प्रगति की रिपोर्ट करें।
कार्य पूरा करें — complete_task का उपयोग करके विस्तृत समाप्ति नोट्स के साथ कार्य को पूर्ण चिह्नित करें।
मानव इनपुट का अनुरोध करें — create_discussion के माध्यम से अवरोधों या निर्णयों के लिए चर्चा बनाएं।
कनेक्टिविटी सत्यापित करें — health_check के साथ Buildable API कनेक्शन स्थिति की जाँच करें।

दस्तावेज़

@bldbl/mcp

Buildable के लिए आधिकारिक MCP क्लाइंट - AI-संचालित विकास मंच जो किसी भी परियोजना को निर्माण योग्य बनाता है

यह पैकेज AI सहायकों (Claude, GPT, आदि) को मॉडल संदर्भ प्रोटोकॉल (MCP) का उपयोग करके सीधे Buildable परियोजनाओं के साथ काम करने में सक्षम बनाता है। AI सहायक परियोजना संदर्भ प्राप्त कर सकते हैं, कार्यों का प्रबंधन कर सकते हैं, प्रगति को ट्रैक कर सकते हैं और मानव डेवलपर्स के साथ संवाद कर सकते हैं।

🌟 Buildable क्या है?

Buildable (bldbl.dev) एक AI-संचालित विकास मंच है जो किसी भी परियोजना को निर्माण योग्य बनाता है। यह प्रदान करता है:

AI-जनित निर्माण योजनाएँ: कार्यान्वयन विवरण के साथ व्यापक परियोजना रोडमैप
स्मार्ट कार्य प्रबंधन: निर्भरताओं और प्राथमिकताओं के साथ स्वचालित कार्य विश्लेषण
AI सहायक एकीकरण: Claude, GPT और अन्य AI सहायकों के साथ सीधा एकीकरण
वास्तविक समय सहयोग: जटिल परियोजनाओं पर निर्बाध मानव-AI सहयोग
प्रगति ट्रैकिंग: विकास प्रगति और अवरोधों की लाइव निगरानी

🚀 सुविधाएँ

पूर्ण परियोजना एकीकरण: संपूर्ण परियोजना संदर्भ, योजनाएँ और कार्य विवरण प्राप्त करें
स्वायत्त कार्य प्रबंधन: कार्य शुरू करें, प्रगति अपडेट करें और पूर्ण करें
मानव सहयोग: प्रश्नों और अवरोधों के लिए चर्चाएँ बनाएँ
वास्तविक समय प्रगति ट्रैकिंग: लाइव अपडेट और स्थिति निगरानी
प्रकार-सुरक्षित API: व्यापक प्रकार परिभाषाओं के साथ पूर्ण TypeScript समर्थन
Claude Desktop तैयार: निर्बाध Claude Desktop एकीकरण के लिए CLI इंटरफ़ेस

📦 स्थापना

Smithery के माध्यम से स्थापित करना

Claude Desktop के लिए @bldbl/mcp को Smithery के माध्यम से स्वचालित रूप से स्थापित करने के लिए:

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

मैन्युअल स्थापना

npm install @bldbl/mcp

🚀 त्वरित शुरुआत

चरण 1: MCP सर्वर स्थापित करें

npm install -g @bldbl/mcp

चरण 2: अपनी Buildable API कुंजी प्राप्त करें

bldbl.dev पर जाएं और एक खाता बनाएं
एक परियोजना बनाएं या चुनें
परियोजना सेटिंग्स → AI सहायक → API कुंजी उत्पन्न करें पर जाएं

चरण 3: अपने AI सहायक को कॉन्फ़िगर करें

🤖 Claude Desktop के लिए:

इसे अपने Claude Desktop कॉन्फ़िग फ़ाइल (~/.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"
      }
    }
  }
}

न्यूनतम सेटअप - केवल API URL स्वतः-पहचाना जाता है।

✨ Cursor AI के लिए:

विकल्प 1: एक-क्लिक सेटअप (अनुशंसित)

bldbl.dev पर अपनी परियोजना पर जाएं
एकीकरण पर नेविगेट करें
"Cursor में जोड़ें" पर क्लिक करें - हो गया! 🎉

विकल्प 2: मैन्युअल कॉन्फ़िगरेशन इसे अपनी Cursor AI कॉन्फ़िग फ़ाइल में जोड़ें:

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

न्यूनतम सेटअप - केवल API URL स्वतः-पहचाना जाता है।

चरण 4: AI-संचालित विकास शुरू करें!

एक बार कॉन्फ़िगर हो जाने पर, आपके AI सहायक के पास इन शक्तिशाली उपकरणों तक पहुंच होती है:

🏗️ get_project_context - अपनी संपूर्ण परियोजना संरचना को समझें
📋 get_next_task - प्राथमिकताओं के आधार पर आगे क्या काम करना है, खोजें
▶️ start_task - किसी विशिष्ट कार्य पर काम शुरू करें
📊 update_progress - विस्तृत प्रगति अपडेट रिपोर्ट करें
✅ complete_task - व्यापक नोट्स के साथ कार्यों को पूर्ण चिह्नित करें
💬 create_discussion - जब आपको मानव इनपुट की आवश्यकता हो तो प्रश्न पूछें
🔍 health_check - Buildable से कनेक्शन सत्यापित करें

💡 उदाहरण 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?"

🔧 उन्नत कॉन्फ़िगरेशन

पर्यावरण चर

उचित AI सहायक ट्रैकिंग के लिए 3 पर्यावरण चर अनुशंसित हैं:

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)

AI सहायक ID क्यों मायने रखती है: इससे आपको अपने परियोजना डैशबोर्ड में यह ट्रैक करने में मदद मिलती है कि कौन सा AI सहायक क्या काम कर रहा है।

CLI उपयोग

आप MCP सर्वर को सीधे भी चला सकते हैं:

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

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

एकाधिक परियोजनाएँ

एकाधिक Buildable परियोजनाओं के साथ काम करने के लिए, विभिन्न MCP सर्वर कॉन्फ़िग बनाएं:

{
  "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 संदर्भ

BuildPlannerMCPClient

Buildable परियोजनाओं के साथ इंटरैक्ट करने के लिए मुख्य क्लाइंट वर्ग।

कंस्ट्रक्टर

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

कॉन्फ़िग पैरामीटर:

apiUrl: Buildable API URL (डिफ़ॉल्ट 'https://bldbl.dev/api')
apiKey: आपकी Buildable API कुंजी ('bp_' से शुरू होती है)
projectId: लक्ष्य परियोजना ID
aiAssistantId: आपके AI सहायक के लिए अद्वितीय पहचानकर्ता
timeout: मिलीसेकंड में अनुरोध टाइमआउट (डिफ़ॉल्ट: 30000)

विकल्प:

retryAttempts: पुनर्प्रयास प्रयासों की संख्या (डिफ़ॉल्ट: 3)
retryDelay: पुनर्प्रयासों के बीच ms में विलंब (डिफ़ॉल्ट: 1000)

विधियाँ

`getProjectContext(): Promise<ProjectContext>`

योजना, कार्यों और हाल की गतिविधि सहित संपूर्ण परियोजना संदर्भ प्राप्त करें।

`getNextTask(): Promise<NextTaskResponse>`

निर्भरताओं और प्राथमिकता के आधार पर काम करने के लिए अगला अनुशंसित कार्य प्राप्त करें।

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

वैकल्पिक दृष्टिकोण और समय अनुमानों के साथ किसी विशिष्ट कार्य पर काम शुरू करें।

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

विस्तृत स्थिति जानकारी के साथ वर्तमान कार्य पर प्रगति अपडेट करें।

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

विस्तृत समापन जानकारी के साथ किसी कार्य को पूर्ण के रूप में चिह्नित करें।

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

जब आपको मार्गदर्शन की आवश्यकता हो तो मानव इनपुट के लिए चर्चा/प्रश्न बनाएं।

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

Buildable API की कनेक्टिविटी और स्वास्थ्य की जाँच करें।

`disconnect(): Promise<void>`

क्लाइंट कनेक्शन को उचित रूप से डिस्कनेक्ट और साफ करें।

🔐 प्रमाणीकरण

API कुंजी उत्पन्न करें: अपनी Buildable परियोजना → AI सहायक टैब → API कुंजी उत्पन्न करें पर जाएं
सुरक्षित भंडारण: अपनी API कुंजी को सुरक्षित रूप से संग्रहीत करें (पर्यावरण चर अनुशंसित)
कुंजी प्रारूप: API कुंजियाँ bp_ से शुरू होती हैं जिसके बाद परियोजना और यादृच्छिक पहचानकर्ता होते हैं

🐛 त्रुटि प्रबंधन

क्लाइंट में व्यापक त्रुटि प्रबंधन शामिल है:

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

🔄 विकास कार्यप्रवाह

Buildable के साथ विशिष्ट AI सहायक कार्यप्रवाह:

प्रारंभ करें - API कुंजी के साथ Buildable से कनेक्ट करें
संदर्भ प्राप्त करें - परियोजना संरचना और वर्तमान स्थिति को समझें
काम खोजें - अगला प्राथमिकता कार्य प्राप्त करें
कार्य शुरू करें - दृष्टिकोण और अनुमानों के साथ काम शुरू करें
प्रगति अपडेट - विवरण के साथ नियमित प्रगति रिपोर्ट
प्रश्न पूछें - अवरोधों या निर्णयों के लिए चर्चाएँ बनाएं
कार्य पूर्ण करें - व्यापक समापन नोट्स के साथ समाप्त करें
दोहराएँ - अगले कार्यों के साथ जारी रखें

📊 उपयोग आँकड़े

// 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 उपयोग

एक बार स्थापित होने के बाद, आप CLI का कई तरीकों से उपयोग कर सकते हैं:

# 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

आवश्यक पर्यावरण चर:

BUILDABLE_API_URL - आपका Buildable API URL
BUILDABLE_API_KEY - आपकी API कुंजी ('bp_' से शुरू होती है)
BUILDABLE_PROJECT_ID - लक्ष्य परियोजना ID
BUILDABLE_AI_ASSISTANT_ID - अद्वितीय सहायक पहचानकर्ता

🧪 परीक्षण

पैकेज में व्यापक परीक्षण उपयोगिताएँ शामिल हैं:

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

🔗 लिंक

🌐 होमपेज: bldbl.dev
📚 दस्तावेज़ीकरण: bldbl.dev/docs
💬 समुदाय: Discord
🐛 समर्थन: support@bldbl.dev
📦 NPM पैकेज: npmjs.com/package/@bldbl/mcp

🏗️ निर्मित सामग्री

TypeScript - प्रकार-सुरक्षित विकास
मॉडल संदर्भ प्रोटोकॉल (MCP) - मानकीकृत AI सहायक संचार
Node.js - रनटाइम वातावरण
REST API - सरल और विश्वसनीय संचार

📄 लाइसेंस

यह सॉफ़्टवेयर मालिकाना और गोपनीय है। अनधिकृत प्रतिलिपि, वितरण या उपयोग सख्त वर्जित है।

Buildable टीम द्वारा ❤️ से निर्मित

Buildable एक वाणिज्यिक AI-संचालित विकास मंच है। आरंभ करने के लिए bldbl.dev पर जाएं।

🆘 समर्थन

दस्तावेज़ीकरण: https://bldbl.dev/docs
ईमेल: support@bldbl.dev
वेबसाइट: https://bldbl.dev

BuildPlanner टीम द्वारा ❤️ से निर्मित