IBM wxflows MCP Server

Sử dụng watsonx.ai Flows Engine với Model Context Protocol (MCP)

Đây là hướng dẫn từng bước để thiết lập và triển khai một dự án với wxflows, bao gồm cài đặt các công cụ cần thiết, triển khai ứng dụng và chạy cục bộ.

Ví dụ này bao gồm các phần sau:

• MCP TypeScript SDK (máy chủ mcp)
• wxflows SDK (công cụ)

Bạn có thể sử dụng bất kỳ máy khách MCP được hỗ trợ nào.

Hướng dẫn này sẽ hướng dẫn bạn cài đặt CLI wxflows, khởi tạo và triển khai một dự án, và chạy ứng dụng cục bộ. Chúng ta sẽ sử dụng các công cụ google_books và wikipedia làm ví dụ cho việc gọi công cụ với wxflows.

Trước khi bắt đầu

Sao chép kho lưu trữ này và mở đúng thư mục:

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

Bước 1: Thiết lập wxflows

Trước khi bạn có thể bắt đầu xây dựng các ứng dụng AI sử dụng watsonx.ai Flows Engine:

1. Đăng ký một tài khoản miễn phí
2. Tải xuống & cài đặt CLI Node.js
3. Xác thực tài khoản của bạn

Bước 2: Triển khai một dự án Flows Engine

Di chuyển vào thư mục wxflows:

cd wxflows

Đã có sẵn một dự án wxflows được thiết lập trong kho lưu trữ này với các giá trị sau:

• Định nghĩa một điểm cuối api/mcp-example cho dự án.
• Nhập công cụ google_books với mô tả để tìm kiếm sách và chỉ định các trường books|book.
• Nhập công cụ wikipedia với mô tả để tìm kiếm Wikipedia và chỉ định các trường search|page.

Bạn có thể triển khai cấu hình công cụ này đến một điểm cuối Flows Engine bằng cách chạy:

wxflows deploy

Lệnh này triển khai điểm cuối và các công cụ đã định nghĩa, chúng sẽ được sử dụng bởi SDK wxflows trong ứng dụng của bạn.

Bước 3: Thiết lập Biến Môi trường

Từ thư mục gốc của dự án, sao chép tệp môi trường mẫu để tạo tệp .env của bạn:

cp .env.sample .env

Chỉnh sửa tệp .env và thêm thông tin xác thực của bạn, chẳng hạn như khóa API và các biến môi trường cần thiết khác. Đảm bảo thông tin xác thực chính xác để cho phép các công cụ xác thực và tương tác với các dịch vụ bên ngoài.

Bước 4: Cài đặt Phụ thuộc trong Ứng dụng

Để chạy ứng dụng, bạn cần cài đặt các phụ thuộc cần thiết:

npm i

Lệnh này cài đặt tất cả các gói cần thiết, bao gồm gói @wxflows/sdk và bất kỳ phụ thuộc nào được chỉ định trong dự án.

Bước 5: Xây dựng máy chủ MCP

Xây dựng máy chủ bằng cách chạy:

npm run build

Bước 6: Sử dụng trong một máy khách MCP

Cuối cùng, bạn có thể sử dụng máy chủ MCP trong một máy khách. Để sử dụng với Claude Desktop, thêm cấu hình máy chủ:

Trên MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Trên 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"
      }
    }
  }
}

Bây giờ bạn có thể mở Claude Desktop và sẽ thấy các công cụ từ wxflows-server được liệt kê. Bạn có thể kiểm tra các công cụ google_books và wikipedia thông qua Claude Desktop.

Tóm tắt

Bạn đã thiết lập, triển khai và chạy thành công một dự án wxflows với các công cụ google_books và wikipedia. Thiết lập này cung cấp một môi trường linh hoạt để tận dụng các công cụ bên ngoài cho việc truy xuất dữ liệu, cho phép bạn tiếp tục xây dựng và mở rộng ứng dụng của mình với wxflows. Xem hướng dẫn trong công cụ để thêm nhiều công cụ hơn hoặc tạo công cụ của riêng bạn từ Cơ sở dữ liệu, NoSQL, REST hoặc API GraphQL.

Hỗ trợ

Vui lòng liên hệ với chúng tôi trên Discord nếu bạn có bất kỳ câu hỏi nào hoặc muốn chia sẻ phản hồi. Chúng tôi rất mong nhận được ý kiến từ bạn!

Cài đặt

Để sử dụng với Claude Desktop, thêm cấu hình máy chủ:

Trên MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Trên Windows: %APPDATA%/Claude/claude_desktop_config.json

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

Gỡ lỗi

Vì các máy chủ MCP giao tiếp qua stdio, việc gỡ lỗi có thể gặp khó khăn. Chúng tôi khuyên bạn nên sử dụng MCP Inspector, có sẵn dưới dạng một tập lệnh gói:

npm run inspector

Inspector sẽ cung cấp một URL để truy cập các công cụ gỡ lỗi trong trình duyệt của bạn.