IBM wxflows MCP Server

Model Context Protocol (MCP) ile watsonx.ai Flows Engine Kullanımı

İşte wxflows ile bir proje kurmak ve dağıtmak için adım adım bir eğitim; gerekli araçların yüklenmesi, uygulamanın dağıtılması ve yerel olarak çalıştırılması dahil.

Bu örnek aşağıdaki parçalardan oluşur:

• MCP TypeScript SDK (mcp sunucusu)
• wxflows SDK (araçlar)

Desteklenen MCP istemcilerinden herhangi birini kullanabilirsiniz.

Bu kılavuz, wxflows CLI'nin yüklenmesi, bir projenin başlatılması ve dağıtılması ve uygulamanın yerel olarak çalıştırılması adımlarında size yol gösterecektir. wxflows ile araç çağırma örnekleri olarak google_books ve wikipedia araçlarını kullanacağız.

Başlamadan önce

Bu depoyu klonlayın ve doğru dizini açın:

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

Adım 1: wxflows'u kurun

watsonx.ai Flows Engine kullanarak AI uygulamaları oluşturmaya başlamadan önce:

1. Ücretsiz bir hesap için kaydolun
2. Node.js CLI'yi indirin ve yükleyin
3. Hesabınızı doğrulayın

Adım 2: Bir Flows Engine projesi dağıtın

wxflows dizinine geçin:

cd wxflows

Bu depoda sizin için aşağıdaki değerlerle önceden ayarlanmış bir wxflows projesi bulunmaktadır:

• Proje için bir uç nokta tanımlar api/mcp-example.
• Kitap aramak ve books|book alanlarını belirtmek için bir açıklama ile google_books aracını içe aktarır.
• Wikipedia aramaları ve search|page alanlarını belirtmek için bir açıklama ile wikipedia aracını içe aktarır.

Bu araç yapılandırmasını aşağıdaki komutu çalıştırarak bir Flows Engine uç noktasına dağıtabilirsiniz:

wxflows deploy

Bu komut, tanımlanan uç noktayı ve araçları dağıtır; bunlar uygulamanızda wxflows SDK tarafından kullanılacaktır.

Adım 3: Ortam Değişkenlerini Ayarlayın

Projenin kök dizininden, .env dosyanızı oluşturmak için örnek ortam dosyasını kopyalayın:

cp .env.sample .env

.env dosyasını düzenleyin ve API anahtarları ve diğer gerekli ortam değişkenleri gibi kimlik bilgilerinizi ekleyin. Araçların kimlik doğrulaması yapmasına ve harici hizmetlerle etkileşime girmesine izin vermek için kimlik bilgilerinin doğru olduğundan emin olun.

Adım 4: Uygulamadaki Bağımlılıkları Yükleyin

Uygulamayı çalıştırmak için gerekli bağımlılıkları yüklemeniz gerekir:

npm i

Bu komut, @wxflows/sdk paketi ve projede belirtilen tüm bağımlılıklar dahil olmak üzere gerekli tüm paketleri yükler.

Adım 5: MCP sunucusunu oluşturun

Aşağıdaki komutu çalıştırarak sunucuyu oluşturun:

npm run build

Adım 6: Bir MCP istemcisinde kullanın

Son olarak, MCP sunucusunu bir istemcide kullanabilirsiniz. Claude Desktop ile kullanmak için sunucu yapılandırmasını ekleyin:

MacOS'ta: ~/Library/Application Support/Claude/claude_desktop_config.json Windows'ta: %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"
      }
    }
  }
}

Artık Claude Desktop'ı açabilir ve wxflows-server araçlarının listelendiğini görmelisiniz. Artık Claude Desktop aracılığıyla google_books ve wikipedia araçlarını test edebilirsiniz.

Özet

google_books ve wikipedia araçlarıyla bir wxflows projesini başarıyla kurdunuz, dağıttınız ve çalıştırdınız. Bu kurulum, veri alımı için harici araçlardan yararlanmak için esnek bir ortam sağlar ve uygulamanızı wxflows ile daha da geliştirmenize ve genişletmenize olanak tanır. Daha fazla araç eklemek veya Veritabanları, NoSQL, REST veya GraphQL API'lerinden kendi araçlarınızı oluşturmak için araçlar bölümündeki talimatlara bakın.

Destek

Sorularınız varsa veya geri bildirim paylaşmak isterseniz lütfen Discord üzerinden bize ulaşın. Sizden haber almayı çok isteriz!

Kurulum

Claude Desktop ile kullanmak için sunucu yapılandırmasını ekleyin:

MacOS'ta: ~/Library/Application Support/Claude/claude_desktop_config.json Windows'ta: %APPDATA%/Claude/claude_desktop_config.json

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

Hata Ayıklama

MCP sunucuları stdio üzerinden iletişim kurduğundan, hata ayıklama zor olabilir. Bir paket betiği olarak sunulan MCP Inspector aracını kullanmanızı öneririz:

npm run inspector

Inspector, tarayıcınızda hata ayıklama araçlarına erişmek için bir URL sağlayacaktır.