> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 内蔵 MCP server

> bricks-ctor に同梱された MCP server

bricks-ctor には内蔵 MCP server が含まれており、`bun install` の実行時に自動的に設定されます。postinstall スクリプトが `.mcp.json` に `bricks-ctor` エントリを追加します：

```json theme={null}
{
  "mcpServers": {
    "bricks-ctor": {
      "command": "bun",
      "args": ["./node_modules/@fugood/bricks-ctor/tools/mcp-server.ts"]
    }
  }
}
```

このサーバーは、AI コーディングエージェント（Claude Code、Codex、CTOR など）が内蔵ツールと組み合わせて使用できる、プロジェクト固有のツールを提供します。

<Info>
  MCP server の設定と管理の詳細については、[CTOR MCP リファレンス](/ja/ctor/reference/mcp) を参照してください。
</Info>

## 利用可能なツール

<AccordionGroup>
  <Accordion title="compile" icon="hammer">
    型チェックを実行してプロジェクトをコンパイルします。

    プロジェクトディレクトリで `bun compile` を実行し、ビルド出力を返します。
  </Accordion>

  <Accordion title="preview" icon="eye">
    アプリをコンパイルしてヘッドレスプレビューを起動し、スクリーンショットを撮影します。

    | パラメーター          | デフォルト | 説明                             |
    | --------------- | ----- | ------------------------------ |
    | `delay`         | 3000  | スクリーンショット撮影前の待機ミリ秒数            |
    | `width`         | 600   | スクリーンショットの幅                    |
    | `height`        | 480   | スクリーンショットの高さ                   |
    | `responseImage` | false | スクリーンショットを base64 画像コンテンツとして返す |
    | `testId`        | —     | トリガーする自動化テスト ID                |
    | `testTitleLike` | —     | 部分タイトル一致で自動化テストを検索             |

    <Info>
      このサーバーが [CTOR](/ja/ctor) 内で動作するときは無効化されます — CTOR のエージェントは組み込みの[プレビューペイン](/ja/ctor/reference/preview)を直接駆動するため、スクリーンショットはペインの表示と一致します。
    </Info>
  </Accordion>

  <Accordion title="icon_search" icon="icons">
    キーワードで内蔵の FontAwesome 6 Pro アイコンセットを検索します。

    | パラメーター  | デフォルト | 説明                                                             |
    | ------- | ----- | -------------------------------------------------------------- |
    | `query` | —     | 検索キーワード                                                        |
    | `limit` | 10    | 最大結果数                                                          |
    | `style` | —     | スタイルでフィルター：`brands`、`duotone`、`light`、`regular`、`solid`、`thin` |

    一致するアイコン名、Unicode コード、利用可能なスタイルを返します。
  </Accordion>

  <Accordion title="lottie_search / lottie_popular / lottie_get_details" icon="film">
    LottieFiles から Lottie アニメーションを検索・ブラウズします。

    * **lottie\_search** — ページネーション付きキーワード検索
    * **lottie\_popular** — 今週の人気アニメーションをブラウズ
    * **lottie\_get\_details** — ID で特定のアニメーションの詳細を取得
  </Accordion>

  <Accordion title="huggingface_search / huggingface_select" icon="microchip">
    Hugging Face から AI モデルを検索・選択して BRICKS ジェネレーターで使用します。

    **huggingface\_search** — ジェネレータータイプでフィルタリングしてモデルを検索します。

    | パラメーター          | デフォルト          | 説明                                                                                                                                                                      |
    | --------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | `generatorType` | `GeneratorLLM` | ジェネレータータイプ（`GeneratorLLM`、`GeneratorVectorStore`、`GeneratorReranker`、`GeneratorGGMLTTS`、`GeneratorGGMLTTSVocoder`、`GeneratorOnnxLLM`、`GeneratorOnnxSTT`、`GeneratorTTS`） |
    | `query`         | —              | 検索キーワード                                                                                                                                                                 |
    | `limit`         | 20             | 最大結果数                                                                                                                                                                   |
    | `includeFiles`  | false          | モデルファイル一覧を含める                                                                                                                                                           |

    **huggingface\_select** — 特定のモデルファイルのダウンロード URL とメタデータを取得します。GGUF および ONNX モデル、分割ファイル、マルチモーダル投影ファイル、スピーカー埋め込みをサポートします。

    <Tip>
      Hugging Face のゲートモデルにアクセスするには、`HF_TOKEN` 環境変数を設定してください。
    </Tip>
  </Accordion>

  <Accordion title="media_boxes / media_files / media_file / media_get_box / media_upload_files" icon="photo-film">
    CLI 経由で [BRICKS](https://bricks.tools) ワークスペースのメディアアセットを管理します。

    * **media\_boxes** — すべてのメディアボックスを一覧表示
    * **media\_get\_box** — 特定のメディアボックスの詳細を取得
    * **media\_files** — ボックス内のファイルを一覧表示（タイプ・タグでフィルター、ページネーション付き）
    * **media\_file** — 特定のファイルの詳細を取得
    * **media\_upload\_files** — ファイルをボックスにアップロード（任意の画像リサイズ、AI 分析、タグ付けに対応）
  </Accordion>
</AccordionGroup>