Worker17

🚀 工人17号監視と制御システム（MCPを介した3D作業員監視と制御）

このシステムは、工人17号の位置と状態の監視、タスク指示の送信、タスクの中止などの機能を提供します。Claude DesktopとMCPを通じて、AIを活用した作業員管理を実現します。

🚀 クイックスタート

開発環境のセットアップ

# サーバーを起動する
cd server
npm install
npm start

# 別のターミナルウィンドウでWebアプリケーションを起動する
npm install
npm start

WebContainerモード

開発やデモのために、WebContainerを使ってブラウザ内でサーバーコードを直接実行できます。

# 開発環境でのWebContainer実行（自動的にサーバーコードをビルド）
npm run dev:wc

# 本番環境でのWebContainerビルド
npm run build:wc

# 本番ビルド版のWebContainerをプレビューする
npm run preview:wc

このモードでは、別途サーバープロセスを起動する必要がなく、ブラウザ内でNode.jsベースの開発環境を実行できます。

Dockerコンテナ化デプロイ

Dockerを使ってシステム全体を実行することもできます。

docker-compose up

注意: WSL（Windows Subsystem for Linux）を使用し、Docker Desktopをインストールしていない場合、現在のバージョンにはポートを正しく公開できないバグがあります。解決策として、ホストネットワークモードでコンテナを実行することができますが、これはコンテナのネットワーク分離機能を迂回するため、一定のセキュリティリスクがあります。

MCP Inspectorツール

MCP Inspectorを使って、工人17号MCPサーバーに接続し、作業員の状態情報を確認できます。SSE転送プロトコルを選択し、工人17号サーバーのアドレスをhttp://localhost:4000/sse（または実際に動作しているサーバーアドレス）に設定します。

Claude Desktopの設定

現在、Claude DesktopはSSE MCPサーバーに直接接続することができません。工人17号MCPサーバーを使用するには、代理Stdio MCPサーバーが必要です。テストの結果、mcp - proxyの使用をおすすめします。インストール後、このツールをシステムパスに追加してください（例えば、Windows環境ではユーザーの個人ディレクトリ下のbinフォルダ）。 その後、Claude Desktopの設定ファイルに工人17号MCPサーバーを追加できます。

{
  "mcpServers": {
    "worker17": {
        "command": "mcp-proxy",
        "args": ["http://localhost:4000/sse"]
    }
  }
}

Claude Desktopを起動する前に、工人17号サーバーが正常に動作していることを確認してください。

✨ 主な機能

• 工人17号の位置と状態の監視
• 工人17号へのタスク指示の送信
• 工人17号のタスク実行の中止
• Claude Desktopを通じたMCPによる監視、制御、中止

📦 システム構成

• Webアプリケーション：React、Three.js、WebSocketを使って実装された工人17号の状態を3Dで可視化するインターフェース
• サーバーサイド：Node.js/Expressフレームワークをベースに、WebSocketサポートとSSE MCPプロトコルを統合したサーバー実装
• MCP統合：Claude Desktopと互換性があり、AIを利用した工人17号の管理をサポート

🔍 もう少し真面目に？

工人17号は当初、冗談として始まったプロジェクトでしたが、その後SSE MCPサーバーの研究に発展しました。このプロジェクトは少し奇妙ですが、MCPプロトコルを学ぶための面白い学習材料になります。