handwork

handwork

物理的な現場で人の手が必要な仕事があります。何かを作る、測定する、組み立てる、テストする、または発送する仕事です。handwork は、エージェントを、まさにそうした仕事を引き受ける人間のサービス窓口につなぐ、小規模な MCP サーバーです。サービスカタログ、見積もり依頼、ステータス照会の3つのツールを提供し、それぞれの呼び出しを窓口の公開リモートエンドポイントに転送して、応答を変更せずに返します。

見積もりを依頼しても、注文したことにはなりません。見積もりがメールで届き、それをメール上で承諾するまでは、料金が発生することも、何かが作られることもありません。ツール自体には、注文や支払いの機能はありません。

ツール

• list_services — サービスで対応できることとできないこと、受け付けないカテゴリ、価格例、支払い方法、主な契約条件を確認できます。引数は不要で、認証も必要ありません。
• request_quote — 物理的な作業（内容、必要なサービス、納品物、期限、配送先住所、入力ファイル、通貨）と、クライアントの請求先情報を説明すると、人間が内容を確認し、24時間以内に固定価格の見積もりをメールで返信します。返信には quote_id と access_token が含まれます。トークンはリクエストを再確認する唯一の手段なので、保管してください。最上位のフィールドは必須ではありませんが、ネストされた task オブジェクトには description が、ネストされた client オブジェクトには email と name が必要です。
• get_status — 以前の見積もり依頼の状態を確認できます。id（quote_id）と access_token の両方が必要です。記録は90日間保持され、見積もり自体はメールで届きます。

動作の仕組み

handwork は転送を行うクライアントであり、機能を再実装するものではありません。リモートが公開しているツール定義をもとに、tools/list は handwork 自身が提供します。また、tools/call ごとに上流とのストリーミング可能な HTTP JSON-RPC セッションを開始し、initialize、続いて notifications/initialized、その後に呼び出しを行います。上流が Mcp-Session-Id ヘッダーを発行した場合は、常にそのヘッダーを付けます。そして、上流の結果をそのまま渡します。上流に接続できない場合やエラーが返された場合は、結果を捏造せず、handwork error: メッセージで呼び出しが失敗します。

上流のエンドポイントのデフォルトは https://handsforagents.com/mcp です。HANDS_MCP_URL 環境変数を設定すると、クライアントの接続先を別のエンドポイントに変更できます（再構築を容易にするための設定であり、公開サービス自体に上書き設定の記載はありません）。

実行方法

stdio 経由で MCP サーバーとして実行する場合：

npx -y @reneturcios/handwork mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "handwork": {
      "command": "npx",
      "args": ["-y", "@reneturcios/handwork", "mcp"]
    }
  }
}

コンテナで実行する場合（デフォルトのコマンドは mcp です）：

docker run -i ghcr.io/cloudcorprecords/handwork
docker run --rm ghcr.io/cloudcorprecords/handwork --version

CLI

handwork mcp          # serve the tools over stdio
handwork --version    # print the version

その他のサブコマンドを指定すると、使用方法が表示され、コード2で終了します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner via tsx; stubbed upstream, no network
npm run dev     # run the CLI from source

テストでは、fetch の代わりに注入した偽の JSON-RPC 上流に対して転送コアを実行し、ハンドシェイクの順序、セッション処理、応答のそのままの転送、イベントストリーム応答、エラーの提示、および提供される tools/list が取得した上流のインターフェースと完全に一致することを確認します。

ライセンス

MIT — LICENSE を参照してください。