Brand.dev Mcp について
Brand.dev Mcpは、ドメインからブランド情報を取得するTypeScript製MCPサーバーです。Brand.dev APIを使うAgent向けに、ドキュメント検索とサンドボックス内でのTypeScript SDK実行を提供します。
主な機能
- 01ドメインからブランド情報を取得
- 02APIとSDKのドキュメント検索
- 03サンドボックスでTypeScript SDKを実行
- 04ローカルとリモートHTTPでの稼働
活用シーン
- 01ドメインのロゴやブランドカラーを取得
- 02ブランドの説明や分類を調査
- 03Agent経由で再現可能なAPIリクエストを実行
MCP 対応
ドキュメント検索とサンドボックスでのSDKコード実行をMCPツールとして公開します。ローカルまたはStreamable HTTP経由で稼働し、Brand.dev APIキーが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Brand Dev TypeScript MCP サーバー
Stainless を使用して生成されています。
インストール
直接実行
npx を使って MCP サーバーを直接実行できます。
export BRAND_DEV_API_KEY="My API Key"
npx -y brand.dev-mcp@latest
MCP クライアント経由
既存のクライアントの一覧の一部は modelcontextprotocol.io にあります。すでにクライアントをお持ちの場合は、 MCP サーバーのインストール方法について、クライアントのドキュメントを参照してください。
設定 JSON を使用するクライアントでは、次のような形式になります。
{
"mcpServers": {
"brand_dev_api": {
"command": "npx",
"args": ["-y", "brand.dev-mcp"],
"env": {
"BRAND_DEV_API_KEY": "My API Key"
}
}
}
}
Cursor
Cursor をお使いの場合は、下のボタンを使って MCP サーバーをインストールできます。環境変数を
Cursor の mcp.json に設定する必要があります。このファイルは Cursor Settings > Tools & MCP > New MCP Server にあります。
VS Code
MCP をお使いの場合は、下のリンクをクリックして MCP サーバーをインストールできます。環境変数を
VS Code の mcp.json に設定する必要があります。このファイルは、コマンドパレット > MCP: Open User Configuration から開けます。
Claude Code
Claude Code をお使いの場合は、ターミナルで下のコマンドを実行して MCP サーバーをインストールできます。環境変数を
ホームディレクトリにある Claude Code の .claude.json に設定する必要があります。
claude mcp add brand.dev_mcp_api --header "x-brand-dev-api-key: My API Key" --transport http https://brand-dev.stlmcp.com
コードモード
この MCP サーバーは「コードモード」ツール方式を採用しています。この MCP サーバーでは、 エージェントが TypeScript SDK を使ったコードを記述し、そのコードが隔離されたサンドボックスで実行されます。これを実現するため、サーバーはエージェントに次の 2 つのツールを公開します。
-
1 つ目はドキュメント検索ツールで、API/SDK のドキュメントを幅広く検索するために使用できます。
-
2 つ目はコードツールで、エージェントが TypeScript SDK を使ったコードを記述できます。 コードはウェブやファイルシステムにアクセスできないサンドボックス環境で実行されます。その後、コードが返す値や出力する内容はすべて、 ツール呼び出しの結果としてエージェントに返されます。
この方式により、エージェントは非常に複雑なタスクを決定論的かつ再現可能な形で実行できます。
リモートでの実行
--transport=http を指定してクライアントを起動すると、Streamable HTTP トランスポートを使用するリモートサーバーとしてサーバーが起動します。--port 設定で実行するポートを指定でき、--socket 設定を使うと Unix ソケットで実行できます。
Authorization ヘッダーで Bearer 方式を使って認証情報を指定できます。
また、次のヘッダーを使って認証情報を指定することもできます。
| ヘッダー | 対応するクライアントオプション | セキュリティ方式 |
|---|---|---|
x-brand-dev-api-key | apiKey | bearerAuth |
このサーバーが http://localhost:3000 でホストされている場合、設定 JSON は次のようになります。
{
"mcpServers": {
"brand_dev_api": {
"url": "http://localhost:3000",
"headers": {
"Authorization": "Bearer <auth value>"
}
}
}
}
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。