IBM wxflows MCP Server

ทางการ

แพลตฟอร์มเครื่องมือโดย IBM สำหรับสร้าง ทดสอบ และปรับใช้เครื่องมือสำหรับแหล่งข้อมูลใดๆ

GitHub
117

เอกสาร

การใช้ watsonx.ai Flows Engine กับ Model Context Protocol (MCP)

นี่คือบทช่วยสอนแบบทีละขั้นตอนสำหรับการตั้งค่าและปรับใช้โปรเจกต์ด้วย wxflows ซึ่งรวมถึงการติดตั้งเครื่องมือที่จำเป็น การปรับใช้แอป และการรันในเครื่อง

ตัวอย่างนี้ประกอบด้วยส่วนต่างๆ ดังต่อไปนี้:

  • MCP TypeScript SDK (เซิร์ฟเวอร์ mcp)
  • wxflows SDK (เครื่องมือ)

คุณสามารถใช้ ไคลเอนต์ MCP ที่รองรับ ใดก็ได้

คู่มือนี้จะแนะนำคุณเกี่ยวกับการติดตั้ง CLI ของ wxflows การเริ่มต้นและปรับใช้โปรเจกต์ และการรันแอปพลิเคชันในเครื่อง เราจะใช้เครื่องมือ google_books และ wikipedia เป็นตัวอย่างสำหรับการเรียกใช้เครื่องมือด้วย wxflows

ก่อนเริ่มต้น

โคลนที่เก็บนี้และเปิดไดเรกทอรีที่ถูกต้อง:

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

ขั้นตอนที่ 1: ตั้งค่า wxflows

ก่อนที่คุณจะเริ่มสร้างแอปพลิเคชัน AI โดยใช้ watsonx.ai Flows Engine:

  1. ลงทะเบียน เพื่อรับบัญชีฟรี
  2. ดาวน์โหลดและติดตั้ง Node.js CLI
  3. ยืนยันตัวตน บัญชีของคุณ

ขั้นตอนที่ 2: ปรับใช้โปรเจกต์ Flows Engine

ย้ายเข้าไปในไดเรกทอรี wxflows:

cd wxflows

มีโปรเจกต์ wxflows ที่ตั้งค่าไว้แล้วในที่เก็บนี้ โดยมีค่าต่อไปนี้:

  • กำหนดเอนด์พอยต์ api/mcp-example สำหรับโปรเจกต์
  • นำเข้าเครื่องมือ google_books พร้อมคำอธิบายสำหรับการค้นหาหนังสือและระบุฟิลด์ books|book
  • นำเข้าเครื่องมือ wikipedia พร้อมคำอธิบายสำหรับการค้นหา Wikipedia และระบุฟิลด์ search|page

คุณสามารถปรับใช้การกำหนดค่าเครื่องมือนี้ไปยังเอนด์พอยต์ Flows Engine ได้โดยรัน:

wxflows deploy

คำสั่งนี้ปรับใช้เอนด์พอยต์และเครื่องมือที่กำหนดไว้ ซึ่งจะถูกใช้โดย SDK ของ wxflows ในแอปพลิเคชันของคุณ

ขั้นตอนที่ 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 แสดงอยู่ คุณสามารถทดสอบเครื่องมือ google_books และ wikipedia ผ่าน Claude Desktop ได้แล้ว

สรุป

คุณได้ตั้งค่า ปรับใช้ และรันโปรเจกต์ wxflows ด้วยเครื่องมือ google_books และ wikipedia สำเร็จแล้ว การตั้งค่านี้ให้สภาพแวดล้อมที่ยืดหยุ่นในการใช้ประโยชน์จากเครื่องมือภายนอกสำหรับการดึงข้อมูล ช่วยให้คุณสามารถสร้างและขยายแอปของคุณด้วย wxflows ต่อไป ดูคำแนะนำใน เครื่องมือ เพื่อเพิ่มเครื่องมือเพิ่มเติมหรือสร้างเครื่องมือของคุณเองจากฐานข้อมูล, NoSQL, REST หรือ GraphQL APIs

การสนับสนุน

โปรด ติดต่อเราบน 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 เพื่อเข้าถึงเครื่องมือดีบักในเบราว์เซอร์ของคุณ