品牌数据获取服务

品牌获取MCP服务器

模型上下文协议（MCP）服务器，允许人工智能助手从Brandfetch API获取徽标、颜色、字体和公司信息。

特性

• 获取品牌详细信息 –按域名列出的完整品牌简介
• 搜索品牌 –关键字搜索匹配的品牌
• get_brand_logo –浅色/深色主题的SVG/PNG资产
• get_brand_colors –带有元数据的精选调色板
• get_logo_url –按域快速查找徽标URL
• 持续使用跟踪 –基于SQLite的配额管理

智能API使用

此服务器优先处理 按域登录API （高配额，无限制使用），只能退回到 API品牌 （有限配额）必要时：

1. 先查找域名 -具有高使用限制的直接登录域API调用
2. API品牌后备 -仅在域查找失败时使用，每月跟踪配额
3. 持续使用跟踪 -基于SQLite的计数器可防止配额超限
4. 预警系统 -接近API品牌限制时发出警报

需求

• Python 3.10+
• Brandfetch API密钥（徽标和品牌API）
• 紫外线

API密钥设置

您需要来自Brandfetch的两个API密钥：

1. 徽标API密钥 （高配额，用于域查找）
2. API品牌密钥 （配额有限，用于回退搜索）

将两者都添加到您的 .env 文件：

# Brandfetch API Configuration
# Get both keys from https://brandfetch.com/developers

# Logo API Key (high quota, for domain lookups)
BRANDFETCH_CLIENT_ID="paste_logo_key_here"

# Brand API Key (limited quota, for fallback searches)
BRANDFETCH_API_KEY="paste_brand_key_here"

快速入门（一页）

1. 获取正确的API密钥
   访问 https://brandfetch.com/developers 并得到 两者 钥匙：

   • 徽标API密钥 -用于高配额域查找
   • API品牌密钥 -用于回退搜索（配额有限）
     → 需要截图吗？看 API_KEY_SETUP.md.

2. 使用Python在本地运行

   复制

   uv venv && source .venv/bin/activate
   uv pip install -e ".[dev]"
   cp .env.example .env  # then add both BRANDFETCH_CLIENT_ID and BRANDFETCH_API_KEY
   python manual_test.py
   

3. 使用Docker运行（可选）

   复制

   docker build -t brandfetch-mcp .
   docker run --rm \
     -e BRANDFETCH_CLIENT_ID=paste_logo_key \
     -e BRANDFETCH_API_KEY=paste_brand_key \
     brandfetch-mcp
   

4. 连接克劳德桌面

   复制

   {
     "mcpServers": {
       "brandfetch": {
         "command": "uv",
         "args": ["--directory", "/absolute/path/to/brandfetch_mcp", "run", "mcp-brandfetch"],
         "env": { 
           "BRANDFETCH_CLIENT_ID": "paste_logo_key",
           "BRANDFETCH_API_KEY": "paste_brand_key"
         }
       }
     }
   }
   

   重新启动克劳德桌面；寻找锤子图标。

项目结构

关键文件：

• src/brandfetch_mcp/server.py：主MCP服务器实现
• src/brandfetch_mcp/client.py：Brandfetch API客户端
• src/brandfetch_mcp/brandfetch_logo_lookup_checked.py：徽标查找功能

用法

快速健康检查

curl -H "Authorization: Bearer YOUR_KEY" https://api.brandfetch.io/v2/brands/github.com

方便的提示

• “获取stripe.com的品牌详细信息”
• “搜索咖啡品牌”
• “获取github的SVG徽标”
• “netflix.com使用什么调色板？”
• “获取github.com的徽标URL”（快速域名查找）
• “查找GitHub的徽标”（使用启发式方法搜索名称）

贡献

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/fooBar)
3. 提交您的更改(git commit -am 'Add some fooBar')
4. 推到分支(git push origin feature/fooBar)
5. 创建新的Pull请求

许可证

麻省理工学院

故障排除

已知限制

• 发展模式：必须从项目根目录运行(.env 路径解析仅在开发模式下有效）
• 测试覆盖率：一些get_brand_logo测试模拟了错误的层-功能正常，但测试需要更新
• 管道安装：环境文件加载仅在从源代码运行时有效，不适用于pip安装的包

支持

• 打开GitHub问题以查找错误/请求
• Brandfetch API文档
• 模型上下文协议
• 更多设置细节： API_KEY_SETUP.md