ワードウェア-MCP
Wordware MCP（Model Context Protocol）サーバーを使用すると、Wordwareアプリをローカルで実行できます。これにより、Wordwareの強力なAIフローをローカル開発環境に直接統合できるため、Wordwareの機能を活用したアプリケーションのテストと開発が容易になります。
バージョン1.1.5の新機能
- 新しいローカル API エンドポイント ( http://localhost:9000/{WORDWARE\_API\_TOKEN} ) で動作するように更新されました
- もうAPP_IDを指定する必要はありません。ツールは自動的に検出されます。
npx wordware-mcpを使用した対話型インストールプロセス- 自動クロード構成セットアップ
- コマンドライン引数のサポートを備えた拡張CLIインターフェース
- パラメータによるAPIキーの直接指定
- エラー処理とログの改善
- シンプルなコマンド構文によるグローバルインストールのサポート
インストール
最も簡単な方法は、npx を使用した対話型インストール プロセスを使用することです。
これにより、次のことがガイドされます。
- Wordware APIキーを入力する
- Claude 構成のセットアップ (オプション)
npx コマンドは次のことを行います。
- 提供されていない場合は設定の詳細を入力するよう要求します
- 必要な設定ファイルを作成する
- Wordwareアプリを実行するためのローカル環境を設定する
npx コマンドを実行した後、次のコマンドで MCP サーバーを起動できます。
恒久的な設置
パッケージを永続的にインストールする場合:
# Install globally from npm registry
npm install -g wordware-mcp
# Or install locally in your project
npm install wordware-mcp
# Or clone this repository and install globally
git clone https://github.com/{username}/wordware-mcp.git
cd wordware-mcp
npm run install-global
前提条件
このパッケージを使用する前に、次のものが必要です。
- Wordwareアカウント（ wordware.aiでサインアップ）
- Wordware APIキー
- 少なくとも1つのWordwareアプリを導入済み
基本的な使い方
npxを直接使用する（インストール不要）
最初にインストールしなくても、npx を使用して wordware-mcp を実行できます。
# Interactive mode - will prompt for required information
npx wordware-mcp
# Or with command line parameters
npx wordware-mcp --api-key your-api-key --port 3000
# Start MCP server after configuration
npx wordware-mcp start
グローバルコマンドとして
グローバルにインストールされている場合は、次の 2 つの方法のいずれかで実行できます。
# Option 1: Create an .env file in your current directory first (see Configuration section)
wordware-mcp
# Option 2: Pass parameters directly via command line
wordware-mcp --api-key your-api-key --port 3000
コマンドラインオプション
Options:
--api-key, -k <key> Wordware API key (required unless in .env file)
--port, -p <port> Port to run the server on (default: 3000)
--help, -h Show this help message
プロジェクトのパッケージとして
// In your script
import { startMCP } from "wordware-mcp";
// Start the MCP server
startMCP();
構成
MCP サーバーは次の 2 つの方法で構成できます。
1. 環境変数または.envファイル
次の変数を含む.envファイルを作成します。
WORDWARE_API_KEY=your-api-key
PORT=3000
2. コマンドライン引数
コマンドを実行するときに構成を直接渡します。
wordware-mcp -k your-api-key -p 3000
Wordware セットアップの作成
アカウントを作成する
まず、Wordwareアカウントが必要です。wordware.aiにアクセスしてサインインし、アカウントを作成してください。
APIキーを作成する
MCP経由でWordwareフローにアクセスするには、APIキーを作成する必要があります。右上のプロフィール写真をクリック > APIキー > 新しいキーを作成 > キーをコピー
アプリを作成する
さあ、創造力を働かせましょう。実現したいことに合わせてWordwareアプリを作成しましょう。または、探索ページ（ https://app.wordware.ai/explore ）からアプリをフォークすることもできます。
アプリをデプロイする
アプリをMCPとしてトリガーするには、デプロイする必要があります。そのためには、アプリを開いてください。右上に「デプロイ」ボタンが表示されます。次に、デプロイページに移動してください。
app_idを取得する
デプロイメントページに、デプロイメントURL（ https://app.wordware.ai/explore/apps/{app_id}が表示されます。そこからapp_idを取得してください。
Claude Desktopでの使用
この MCP サーバーを Claude Desktop で使用するには:
- Claude for Desktopがインストールされていることを確認してください
- 次の場所にある Claude デスクトップ構成ファイルを変更します:
~/Library/Application\ Support/Claude/claude_desktop_config.json - ファイルに次の内容を追加します。
{
"mcpServers": {
"wordware": {
"command": "wordware-mcp"
}
}
}
完全なワークフロー例
すぐに起動して実行するための完全なワークフローの例を次に示します。
1. Wordware MCPの設定と起動
# Run the interactive setup
npx wordware-mcp
# Follow the prompts to:
# - Enter your Wordware API key
# - Configure Claude integration (if desired)
# Once configured, start the server
npx wordware-mcp start
2. アプリケーションとの統合
MCP サーバーを起動すると、次の場所から Wordware アプリにアクセスできるようになります。
http://localhost:3000/api/run/{app_id}
HTTP リクエストを介して Wordware フローをトリガーできます。
// Example: Calling your Wordware app from JavaScript
async function callWordwareApp() {
const response = await fetch("http://localhost:3000/api/run/your-app-id", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
// Your input data here
prompt: "Your prompt to the AI model",
// Any other parameters your Wordware app expects
}),
});
const result = await response.json();
console.log(result);
}
3. ホットリロードによる開発
開発中は、Wordware アプリに加えた変更はすぐに利用できるようになります。アプリを更新するか、新しい API 呼び出しを行うだけです。
発達
このパッケージに貢献したい場合は:
# Clone the repository
git clone https://github.com/yuhuangou/wordware-mcp.git
cd wordware-mcp
# Install dependencies
npm install
# Build the package
npm run build
# Run in development mode
npm run dev
ライセンス
マサチューセッツ工科大学
トラブルシューティング
npx のよくある問題
- インストール後に「コマンドが見つかりません」npx を使用してインストールした後に
command not found場合:# Make sure the package is installed globally
npm install -g wordware-mcp
# Check your npm global path is in your PATH
npm config get prefix
# Add the resulting path + /bin to your PATH if needed
- 構成の問題構成が検出されない場合:
# Check if .env file exists in current directory
ls -la .env
# Manually run with parameters to bypass .env
npx wordware-mcp --api-key your-api-key
- 接続拒否エラーアプリを使用しようとしたときに接続エラーが表示される場合:
# Check if server is running
lsof -i :3000
# Restart server with verbose logging
npx wordware-mcp start --verbose
- 権限の問題npx で権限エラーが発生した場合:
# Run with sudo (not recommended as permanent solution)
sudo npx wordware-mcp
# Fix npm permissions
chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
さらにサポートが必要な場合は、GitHub リポジトリに問題を報告してください。
環境変数
.envファイルでは次の環境変数を設定できます。
PORT - サーバーを実行するポート（デフォルト: 3000）WORDWARE_API_KEY - Wordware APIキー