11FGB Cleaning Tools

11FGB Cleaning Tools MCP

AI アシスタント、エージェント、ウェブアプリケーション向けの、無料で決定論的な清掃計算ツールです。ホスト型サーバーは、構造化された見積もり、プレーンテキストのフォールバック回答、オプションの MCP Apps ビジュアライゼーションを返します。

本番エンドポイント：https://mcp.11fgb.com/mcp

ドキュメントとインタラクティブな計算ツール：11fgb.com/developers/mcp

ツール

ツール	想定される用途
estimate_home_cleaning_cost	住宅やアパートの料金、人件費、作業人数、所要時間の計画
estimate_office_cleaning_cost	オフィス清掃の訪問ごとの予算と月額予算
estimate_cleaning_time_and_crew	作業量、訪問所要時間、作業人数の算定
calculate_cleaning_chemical_usage	そのまま使える溶液、濃縮液、水、汎用パッケージの数量

すべての結果は計画用の見積もりであり、拘束力のある見積書ではありません。洗浄剤の計算よりも製品ラベルおよび安全データシートが優先されます。メーカーが明示的に指示している場合を除き、洗浄剤を混ぜないでください。

接続

互換性のあるクライアントで、リモートの Streamable HTTP エンドポイントを使用します。

{
  "mcpServers": {
    "11fgb-cleaning-tools": {
      "type": "http",
      "url": "https://mcp.11fgb.com/mcp"
    }
  }
}

アカウントや API キーは不要です。

例

MCP に接続したアシスタントに、次のように依頼します。

ZIP 78704 にある、寝室3室、浴室2室、広さ1,900平方フィートの住宅について、標準的な一回限りの清掃料金を見積もってください。犬が1匹います。

結果には、料金の範囲、人件費、推奨作業人数、予想所要時間、前提、注意事項、30日間のビジュアルレポート URL が含まれます。

ローカルで実行する

要件：Node.js 20 以降。

npm install
npm run dev

開発サーバーは http://localhost:3400 でリッスンします。次のコマンドですべてのチェックを実行します。

npm run check
docker build -t 11fgb-cleaning-tools .

設定

.env.example を自身の環境にコピーしてください。本番環境では、base64 でエンコードしたランダムな32バイトの REPORT_TOKEN_KEY が必要です。オプションの非公開レートフィードを使用すると、同梱の全国およびテキサス州中部向けデモ用料金表を上書きできます。

レポートトークンには、公開スキーマで受け付ける計算入力のみが含まれます。正確な番地は受け付けません。トークンは AES-256-GCM で暗号化され、30日後に期限切れとなり、ユーザーレコードとして永続化されません。

HTTP エンドポイント

エンドポイント	用途
POST /mcp	MCP Streamable HTTP トランスポート
POST /api/v1/calculations/{calculator}	ウェブ計算ツールアダプター
GET /api/v1/reports/{token}	匿名のビジュアルレポートを再計算
GET /health	コンテナーのヘルスチェック
GET /.well-known/mcp/server-card.json	レジストリスキャナーのフォールバック
POST /api/v1/events	匿名の集計レポート操作イベント

方法とデータ

計算エンジンは決定論的で、バージョン管理されています。公開フォールバック料金は data/rates.json にあり、ホスト型の本番環境では CALCULATOR_DATA_URL を通じて、より新しい料金表を提供できます。結果には常に方法とデータのバージョンが示され、検証済みのテキサス州中部市場と全国向けの計画用フォールバックが区別されます。

プライバシーとセキュリティ

• ユーザーアカウントは不要です。
• サーバーは正確な番地を要求せず、受け付けません。
• チャットのプロンプト全文は保存されません。
• 匿名の計算にはレート制限が適用されます。
• レポートリンクは暗号化され、30日後に期限切れとなります。
• セキュリティに関する報告：11fgb.com/contact-us。

ライセンス

MIT

本番環境へのデプロイ

本番ワークフローでは、指定された正確なコミット SHA を /opt/11fgb-mcp にデプロイします。タグ付きイメージをビルドし、ポート3401で分離された候補を起動して、ヘルスチェックと MCP の initialize ハンドシェイクを検証した後、ポート3400の Compose サービスを切り替え、ロールバックに備えて前のタグ付きイメージを保持します。コンテナーのメモリ使用量は512 MBに制限され、ログとイメージのローテーションにも上限があります。