Clutter Mcp

clutter-mcp — 合成データと合成ドキュメントの生成ツール（MCP サーバー）

Model Context Protocol の stdio サーバーです。AI エージェントが Clutter の公開 REST API を API キーで認証して利用し、Clutter のパイプライン全体を操作できます。実在しそうな合成企業を作成し、その企業が実際に持っていそうなドキュメント、スプレッドシート、メール、画像、データセットを大量に生成して、完了を確認し、ダウンロード URL を取得できます。

開発・テスト・デモ用システム（SharePoint、CRM、ファイル共有）に、現実味のあるコンテンツを入力するためにお使いください。実データの代わりとなる合成ドキュメントと合成データを、必要に応じてテストデータ、デモデータ、トレーニングデータ、またはテストドキュメントとトレーニングドキュメントとして生成できます。実データや機密データに触れずに、AI エージェントが推論するための現実味のあるデータを提供することもできます。

Clutter のコードベースの他の部分に依存しない、シンプルな HTTPS クライアントです。

クイックスタート

1. https://clutter.run で無料アカウントを作成し、Settings を開いて API キーを発行します（clt_live_…。キーは一度だけ表示されます）。
2. MCP クライアントの設定にサーバーを追加します（Claude Code、Claude Desktop など）。

{
  "mcpServers": {
    "clutter": {
      "command": "npx",
      "args": ["-y", "clutter-mcp"],
      "env": {
        "CLUTTER_API_KEY": "clt_live_…"
      }
    }
  }
}

これで完了です。CLUTTER_API_URL のデフォルトは https://clutter.run/api のため、必要なのはキーだけです。

設定

環境変数	必須	デフォルト	備考
CLUTTER_API_KEY	はい	—	clt_live_… キー（ウェブアプリ → Settings）
CLUTTER_API_URL	いいえ	https://clutter.run/api	別のデプロイ先を指定する場合のみ上書きします

直接実行する

CLUTTER_API_KEY=clt_live_… npx -y clutter-mcp

エージェントの一般的なワークフロー

1. build_org — 企業を一文で説明します → orgId が返されます（projectId を省略するとプロジェクトが自動作成されます）。無料です。
2. wait_for_org — 企業の構築が ready になるまで待機します。
3. create_run — 企業に基づいてコンテンツを生成します。
   • doc_generator → ドキュメントを一括生成します（docx/pdf/xlsx/eml/jpg）。フォルダーごとに整理されます。
   • data_generator → 指定した行数の表形式データセットを1つ生成します（xlsx/csv/json）。
   • doc_metadata_gen → 以前のドキュメント実行に含まれるドキュメントごとに、メタデータレコードを1つ生成します。
4. wait_for_run — 実行が complete になるまで待機します。
5. list_run_documents + get_document_url、または build_zip + get_zip_url を使って、実行全体を1つの ZIP として取得します（フォルダーツリーが保持されるため、SharePoint やファイル共有にそのまま配置できます）。

ツール

• ID / 使用状況： clutter_whoami、get_usage
• プロジェクト： list_projects、create_project、delete_project
• 企業： list_orgs、build_org、get_org、wait_for_org、query_org、delete_org
• 実行： list_runs、create_run、get_run、wait_for_run、list_run_documents、 get_document_url、build_zip、get_zip_url、delete_run

build_org と create_run は非同期です（ID をすぐに返します）。終端状態になるまで待機するには wait_for_* ツールを使うか、get_org / get_run をポーリングしてください。各ツールは REST エンドポイントに対応し、生の JSON レスポンスを返します。

料金

企業の構築、メタデータ、「企業に質問」は無料です。新規アカウントにはドキュメント10件とデータ100行が無料で付与され、その後は従量課金となります（すべて USD 表記：ドキュメント1件あたり $0.10、データ10行あたり $0.06）。create_run から 402 が返された場合は、クレジットが不足しています。https://clutter.run/billing でチャージしてください。

SharePoint へのコンテンツの読み込み

Clutter はダウンロード URL を提供します。アップロードはエージェントが（Microsoft Graph 経由で）行います。生成されたメタデータは、単に「ファイルをライブラリに配置する」用途にとどまらず、自動化にも利用できます。機密ラベルの適用、アクセス許可の設定、保持期間の割り当て、メタデータに応じたフラットファイルの適切なサイト／ライブラリへの振り分け、さらには情報アーキテクチャ自体の生成も可能です。Graph 呼び出しを使った実例は https://clutter.run/sharepoint-cookbook.md をご覧ください。

Reference

Full REST API: https://clutter.run/api/docs (Swagger UI) · machine-readable guide: https://clutter.run/llms.txt

License

MIT