IBM wxflows MCP Server

आधिकारिक

किसी भी डेटा स्रोत के लिए उपकरण बनाने, परीक्षण करने और तैनात करने हेतु IBM का उपकरण प्लेटफॉर्म

GitHub
117

दस्तावेज़

watsonx.ai Flows Engine का मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) के साथ उपयोग

यहाँ wxflows के साथ एक प्रोजेक्ट सेट अप और डिप्लॉय करने के लिए चरण-दर-चरण ट्यूटोरियल दिया गया है, जिसमें आवश्यक उपकरणों की स्थापना, ऐप को डिप्लॉय करना और उसे स्थानीय रूप से चलाना शामिल है।

इस उदाहरण में निम्नलिखित भाग शामिल हैं:

  • MCP TypeScript SDK (mcp सर्वर)
  • wxflows SDK (उपकरण)

आप किसी भी समर्थित MCP क्लाइंट का उपयोग कर सकते हैं।

यह गाइड आपको wxflows CLI स्थापित करने, एक प्रोजेक्ट आरंभ करने और डिप्लॉय करने, और एप्लिकेशन को स्थानीय रूप से चलाने के बारे में बताएगी। हम wxflows के साथ उपकरण कॉलिंग के उदाहरण के रूप में google_books और wikipedia उपकरणों का उपयोग करेंगे।

शुरू करने से पहले

इस रिपॉजिटरी को क्लोन करें और सही निर्देशिका खोलें:

git clone https://github.com/IBM/wxflows.git
cd examples/mcp/javascript

चरण 1: wxflows सेट अप करें

watsonx.ai Flows Engine का उपयोग करके AI एप्लिकेशन बनाना शुरू करने से पहले:

  1. एक मुफ़्त खाते के लिए साइन अप करें
  2. Node.js CLI डाउनलोड और इंस्टॉल करें
  3. अपने खाते को प्रमाणित करें

चरण 2: एक Flows Engine प्रोजेक्ट डिप्लॉय करें

wxflows निर्देशिका में जाएँ:

cd wxflows

इस रिपॉजिटरी में आपके लिए पहले से ही एक wxflows प्रोजेक्ट सेट अप है जिसमें निम्नलिखित मान हैं:

  • प्रोजेक्ट के लिए एक एंडपॉइंट परिभाषित करता है api/mcp-example।
  • पुस्तकें खोजने और फ़ील्ड निर्दिष्ट करने के विवरण के साथ google_books उपकरण आयात करता है books|book।
  • विकिपीडिया खोजों और फ़ील्ड निर्दिष्ट करने के विवरण के साथ wikipedia उपकरण आयात करता है search|page।

आप इस उपकरण कॉन्फ़िगरेशन को चलाकर Flows Engine एंडपॉइंट पर डिप्लॉय कर सकते हैं:

wxflows deploy

यह कमांड परिभाषित एंडपॉइंट और उपकरणों को डिप्लॉय करता है, इनका उपयोग आपके एप्लिकेशन में wxflows SDK द्वारा किया जाएगा।

चरण 3: पर्यावरण चर सेट अप करें

प्रोजेक्ट की रूट निर्देशिका से, अपनी .env फ़ाइल बनाने के लिए नमूना पर्यावरण फ़ाइल कॉपी करें:

cp .env.sample .env

.env फ़ाइल संपादित करें और अपने क्रेडेंशियल जोड़ें, जैसे API कुंजियाँ और अन्य आवश्यक पर्यावरण चर। सुनिश्चित करें कि क्रेडेंशियल सही हैं ताकि उपकरण प्रमाणित हो सकें और बाहरी सेवाओं के साथ इंटरैक्ट कर सकें।

चरण 4: एप्लिकेशन में निर्भरताएँ स्थापित करें

एप्लिकेशन चलाने के लिए आपको आवश्यक निर्भरताएँ स्थापित करनी होंगी:

npm i

यह कमांड सभी आवश्यक पैकेज स्थापित करता है, जिसमें @wxflows/sdk पैकेज और प्रोजेक्ट में निर्दिष्ट कोई भी निर्भरताएँ शामिल हैं।

चरण 5: MCP सर्वर बनाएँ

चलाकर सर्वर बनाएँ:

npm run build

चरण 6: MCP क्लाइंट में उपयोग करें

अंत में, आप MCP सर्वर का उपयोग किसी क्लाइंट में कर सकते हैं। Claude Desktop के साथ उपयोग करने के लिए, सर्वर कॉन्फ़िग जोड़ें:

MacOS पर: ~/Library/Application Support/Claude/claude_desktop_config.json Windows पर: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wxflows-server": {
      "command": "node",
      "args": ["/path/to/wxflows-server/build/index.js"],
      "env": {
        "WXFLOWS_APIKEY": "YOUR_WXFLOWS_APIKEY",
        "WXFLOWS_ENDPOINT": "YOUR_WXFLOWS_ENDPOINT"
      }
    }
  }
}

अब आप Claude Desktop खोल सकते हैं और आपको wxflows-server से उपकरण सूचीबद्ध दिखने चाहिए। अब आप Claude Desktop के माध्यम से google_books और wikipedia उपकरणों का परीक्षण कर सकते हैं।

सारांश

आपने अब google_books और wikipedia उपकरणों के साथ एक wxflows प्रोजेक्ट सफलतापूर्वक सेट अप, डिप्लॉय और चला लिया है। यह सेटअप डेटा पुनर्प्राप्ति के लिए बाहरी उपकरणों का लाभ उठाने के लिए एक लचीला वातावरण प्रदान करता है, जिससे आप wxflows के साथ अपने ऐप को और अधिक बना और विस्तारित कर सकते हैं। अधिक उपकरण जोड़ने या डेटाबेस, NoSQL, REST या GraphQL API से अपने स्वयं के उपकरण बनाने के लिए उपकरण में दिए गए निर्देश देखें।

समर्थन

यदि आपके कोई प्रश्न हैं या प्रतिक्रिया साझा करना चाहते हैं तो कृपया Discord पर हमसे संपर्क करें। हमें आपसे सुनकर खुशी होगी!

स्थापना

Claude Desktop के साथ उपयोग करने के लिए, सर्वर कॉन्फ़िग जोड़ें:

MacOS पर: ~/Library/Application Support/Claude/claude_desktop_config.json Windows पर: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weather-server": {
      "command": "/path/to/weather-server/build/index.js"
    }
  }
}

डिबगिंग

चूँकि MCP सर्वर stdio पर संचार करते हैं, डिबगिंग चुनौतीपूर्ण हो सकती है। हम MCP Inspector का उपयोग करने की अनुशंसा करते हैं, जो एक पैकेज स्क्रिप्ट के रूप में उपलब्ध है:

npm run inspector

Inspector आपके ब्राउज़र में डिबगिंग उपकरणों तक पहुँचने के लिए एक URL प्रदान करेगा।