内容
# 品牌获取MCP服务器
官方 [模型上下文协议](https://modelcontextprotocol.io) 服务器，用于 [品牌获取](https://brandfetch.com)。它为AI助手提供品牌搜索、公司数据、徽标和设计资产，以及LLM-ready的品牌上下文，来自品牌获取API。
完整文档：**https://docs.brandfetch.com/mcp/overview**
## 工具
| 工具 | 描述 |
| -------------------- | -------------------------------------------------------------------------------- |
| `品牌搜索` | 使用品牌获取的搜索索引按名称搜索品牌。 |
| `获取品牌` | 通过域名、股票代码、ISIN或加密货币符号查找完整的品牌数据。 |
| `丰富交易` | 从信用卡或银行对账单字符串中识别商家品牌。 |
| `获取品牌上下文` | 获取域的LLM-ready品牌上下文 — 声音、受众、定位、风格。 |
| `构建徽标网址` | 为一个或多个品牌构造品牌获取徽标CDN网址（无需API调用）。 |
| `获取资产base64` | 以base64形式获取品牌获取CDN资产（徽标、图标、符号、图像）。 |
## 快速开始（托管服务器）
使用此服务器的最简单方法是连接到品牌获取托管的端点 — 无需安装，无需基础设施：
```
https://mcp.brandfetch.io/mcp
```
身份验证使用品牌获取MCP令牌（`bf1.` bearer令牌）。从 **密钥和MCP** 页面在 [品牌获取仪表盘](https://developers.brandfetch.com) 中生成一个令牌，或使用支持OAuth的客户端连接。
### Claude 桌面版 / Claude 代码
```json
{
"mcpServers": {
"brandfetch": {
"type": "http",
"url": "https://mcp.brandfetch.io/mcp",
"headers": {
"Authorization": "Bearer bf1.您的令牌"
}
}
}
}
```
### 光标
添加到 `~/.cursor/mcp.json` （或项目 `.cursor/mcp.json`）：
```json
{
"mcpServers": {
"brandfetch": {
"url": "https://mcp.brandfetch.io/mcp",
"headers": {
"Authorization": "Bearer bf1.您的令牌"
}
}
}
}
```
支持OAuth的客户端可以改为指向 `https://mcp.brandfetch.io/mcp`，无需令牌，在浏览器中完成授权流程。
## 自主托管
这是一个使用 [FastMCP](https://github.com/jlowin/fastmcp) 构建的HTTP（streamable-http）MCP服务器。您可以使用Docker运行自己的实例。
```bash
docker build -t brandfetch-mcp-server .
docker run --rm -p 8080:8080 brandfetch-mcp-server
```
服务器然后监听 `http://localhost:8080/mcp`。将您的MCP客户端指向该网址，并将您的品牌获取凭证作为 `Bearer` 令牌发送。
> `Dockerfile` 捆绑了 [AWS Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter) 和几个 `AWS_LWA_*` 环境变量。这些在AWS Lambda之外是无效的，可以忽略（或删除）用于纯容器/主机部署。
### 在没有Docker的情况下运行
```bash
uv sync
uv run uvicorn src.main:app --host 0.0.0.0 --port 8080
```
## 开发
需要 [uv](https://docs.astral.sh/uv/) 和Python 3.11。
```bash
uv sync # 安装依赖
uv run pytest # 运行测试
uv run ruff check . # 检查代码风格
uv run ruff format . # 格式化代码
```
## 许可证
[MIT](./LICENSE)
