ワードウェア-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キーの直接指定

• エラー処理とログの改善

• シンプルなコマンド構文によるグローバルインストールのサポート

Related MCP server: MCP Web Research Server

インストール

最も簡単な方法は、npx を使用した対話型インストール プロセスを使用することです。

npx wordware-mcp

これにより、次のことがガイドされます。

1. Wordware APIキーを入力する

2. Claude 構成のセットアップ (オプション)

npx コマンドは次のことを行います。

• 提供されていない場合は設定の詳細を入力するよう要求します

• 必要な設定ファイルを作成する

• Wordwareアプリを実行するためのローカル環境を設定する

npx コマンドを実行した後、次のコマンドで MCP サーバーを起動できます。

npx wordware-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

前提条件

このパッケージを使用する前に、次のものが必要です。

1. Wordwareアカウント（ wordware.aiでサインアップ）

2. Wordware APIキー

3. 少なくとも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 で使用するには:

1. Claude for Desktopがインストールされていることを確認してください

2. 次の場所にある Claude デスクトップ構成ファイルを変更します: ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. ファイルに次の内容を追加します。

{
  "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 のよくある問題

1. インストール後に「コマンドが見つかりません」

   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

2. 構成の問題

   構成が検出されない場合:

   # 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

3. 接続拒否エラー

   アプリを使用しようとしたときに接続エラーが表示される場合:

   # Check if server is running
   lsof -i :3000
   
   # Restart server with verbose logging
   npx wordware-mcp start --verbose

4. 権限の問題

   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キー