Brandfetch MCP Server

Brandfetch MCP Server

概述

此 MCP 服务为大模型（LLM）应用与 Brandfetch API 搭建桥梁，让 AI 助手能够搜索品牌并获取全面的品牌信息。通过实现 Model Context Protocol，此服务可将 Brandfetch 的品牌数据功能无缝集成到由大模型驱动的应用中。

功能

• 品牌搜索：按名称搜索品牌并获取基本信息
• 详细品牌信息：获取全面的品牌数据，包括徽标、颜色、字体和公司详情
• 字段筛选：仅请求特定信息，以优化响应大小和处理效率
• 交互式提示词：内置提示词，指导用户正确使用 API
• 类型安全实现：完全类型化的 Python 代码库，支持现代异步功能
• 完善的错误处理：全面的错误处理与日志记录

安装

先决条件

• Python 3.9 或更高版本
• Brandfetch API 凭据（API 密钥和 Client ID）

使用 uv（推荐）

# Create and navigate to a new project directory
uv init brandfetch-mcp
cd brandfetch-mcp

# Clone this repository
git clone https://github.com/VincentSolconBraze/brandfetch-mcp.git .

# Add dependencies
uv add "mcp[cli]" httpx python-dotenv

# For development
uv add --dev pytest pytest-asyncio pytest-cov ruff pyright pre-commit

使用 pip

# Clone this repository
git clone https://github.com/VincentSolconBraze/brandfetch-mcp.git
cd brandfetch-mcp

# Install dependencies
pip install "mcp[cli]" httpx python-dotenv

# For development
pip install pytest pytest-asyncio pytest-cov ruff pyright pre-commit

配置

1. 根据示例创建 .env 文件：

cp .env.example .env

2. 将 Brandfetch API 凭据添加到 .env 文件中：

BRANDFETCH_API_KEY=your_api_key
BRANDFETCH_CLIENT_ID=your_client_id

你可以在 Brandfetch 创建账户并前往 API 部分获取这些凭据。

使用方法

在 Claude Desktop 中运行

可将此服务直接安装到 Claude Desktop，以实现无缝集成：

mcp install brandfetch_server.py

使用 MCP Inspector 测试

使用 MCP Inspector 工具在本地调试和测试此服务：

mcp dev brandfetch_server.py

直接执行

你也可以直接运行此服务：

python brandfetch_server.py

可用工具

search_brands

使用 Brandfetch Search API 按名称搜索品牌。

参数：

• name：要搜索的公司名称。
• client_id（可选）：API 的 Client ID。如果未提供，将使用环境变量中的值。

示例：

Search for brands related to "Nike"

get_brand_info

使用 Brandfetch Brand API 根据标识符获取详细的品牌信息。

参数：

• identifier：品牌标识符（域名、品牌 ID、ISIN 或股票代码）
• fields（可选）：要包含在响应中的特定字段列表

示例：

Get detailed information about nike.com with only logos and colors

示例

examples 目录包含演示如何与此服务交互的示例代码：

• basic_usage.py：简单的品牌搜索和信息获取
• advanced_usage.py：通过字段筛选和结果处理进行高级用法

运行示例：

python examples/basic_usage.py
python examples/advanced_usage.py

测试

运行测试套件以验证服务功能：

pytest

生成覆盖率报告：

pytest --cov=./ --cov-report=term

文档

更多详细文档请参阅以下文件：

• 身份验证指南
• API 参考
• 使用示例

贡献

欢迎贡献！详情请参阅贡献指南。

安全

有关报告安全漏洞的信息，请查看我们的安全策略。

许可证

此项目采用 MIT License 许可，详情请参阅 LICENSE 文件。