Brandfetch

Brandfetch MCP 服务

Brandfetch 的官方 Model Context Protocol 服务。它让 AI 助手能够通过 Brandfetch API 使用品牌搜索、公司数据、徽标和设计素材，以及适用于大模型的品牌背景信息。

• 了解更多：https://brandfetch.com/developers/mcp
• 完整文档：https://docs.brandfetch.com/mcp/overview

工具

工具	描述
brand_search	使用 Brandfetch 的搜索索引按名称搜索品牌。
get_brand	按域名、电子邮件、股票代码、ISIN 或加密货币符号查找完整品牌数据；在支持 MCP Apps 的宿主中呈现交互式品牌卡片。
get_brand_data	返回相同的品牌数据，但不含卡片——适用于生成内容的数据，或单个品牌的完整记录。
get_brands	一次调用最多获取 25 个品牌，以紧凑记录形式返回，不含卡片——适用于徽标墙、比较表和公司列表。
enrich_transaction	根据信用卡或银行对账单中的文本识别商家品牌。
get_brand_context	获取适用于大模型的域名品牌背景信息——品牌声音、受众、定位和风格。
build_logo_urls	为一个或多个品牌构建 Brandfetch Logo CDN URL（无需 API 调用）。
send_feedback	向 Brandfetch 报告错误、错误或过时的品牌数据，以及缺失的功能。

交互式品牌卡片（MCP Apps）

在支持 MCP Apps 扩展的宿主（claude.ai、Claude Desktop 等）上，get_brand 的结果会呈现为交互式品牌卡片：徽标预览、格式切换器（SVG/PNG/WebP/...）、下载和复制 URL 操作。不支持 Apps 的宿主则会回退到常规 JSON 工具结果。get_brand_data 返回相同的品牌数据，但不含卡片；get_brands 可一次调用获取多个品牌，因此包含六个品牌的徽标墙只需一次批量调用，而不是六张卡片；模型会根据描述在三者中进行选择。小组件源代码位于 ui/，服务会将其作为 ui://brandfetch/brand-card.html 资源提供。

快速开始（托管服务）

使用此服务最简单的方式是连接到 Brandfetch 托管的端点——无需安装，也无需基础设施：

https://mcp.brandfetch.io/mcp

身份验证使用 Brandfetch MCP 令牌（bf1. Bearer 令牌）。可在 Brandfetch 控制面板的 Keys and MCP 页面生成，或者通过支持 OAuth 的客户端连接。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "brandfetch": {
      "type": "http",
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

Cursor

添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "brandfetch": {
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

支持 OAuth 的客户端也可以直接使用 https://mcp.brandfetch.io/mcp，无需令牌，并在浏览器中完成授权流程。

配额错误

get_brand、get_brand_data、get_brands、enrich_transaction 和 get_brand_context 会消耗你套餐中的 API 积分；brand_search 和 build_logo_urls 不会消耗积分，即使积分用完也能继续使用。get_brands 每返回一个品牌消耗 1 个积分；其他每种结果都免费。

• 429 "API quota exhausted" — 你的密钥已用完所有 API 积分。 请在 Brandfetch 控制面板中查看用量或升级套餐。
• 429 "Not enough API credits left for this batch" — get_brands 请求的品牌数量超过了你的密钥剩余积分所能支持的数量；不会扣除任何积分。请减少请求的品牌数量。
• 403 "Batch lookups need a paid plan or prepaid credits" — 免费套餐不支持 get_brands；get_brand_data 可以逐个获取相同的品牌。
• 403 "Forbidden" — 密钥没有可用的 API 积分，或无权访问该端点。密钥本身可能有效，因此在轮换密钥前，请先在控制面板中检查套餐和密钥状态。

自托管

这是一个使用 FastMCP 构建的 HTTP（streamable-http）MCP 服务。你可以使用 Docker 运行自己的实例。

docker build -t brandfetch-mcp-server .
docker run --rm -p 8080:8080 brandfetch-mcp-server

随后，服务会监听 http://localhost:8080/mcp。将 MCP 客户端指向该 URL，并将 Brandfetch 凭据作为 Bearer 令牌发送。

Dockerfile 包含 AWS Lambda Web Adapter 和若干 AWS_LWA_* 环境变量。在 AWS Lambda 之外，这些设置不会生效；用于普通容器／主机部署时，可以忽略（或移除）。

不使用 Docker 运行

uv sync
uv run uvicorn src.main:app --host 0.0.0.0 --port 8080

开发

需要 uv 和 Python 3.11。

uv sync                 # install dependencies
uv run pytest           # run the tests
uv run ruff check .     # lint
uv run ruff format .    # format

许可证

MIT