brand-asset-mcp
README.md
# Brand Asset Management MCP Server (`brand-asset-mcp`)
> A shareable, lightweight Model Context Protocol (MCP) server for managing corporate brand assets, logos, color design tokens, social media templates, and image watermarking across multiple locations and platforms.
## Features
- **Brand Design Tokens**: Exposes official HSL / Hex color palettes, typography rules, and theme variables via MCP resources (`brand://tokens`).
- **Logo & Badge Asset Library**: Serves vector SVGs and PNG logo assets for Cape Fear Intel and Simpson Strong-Tie MCP platforms (`brand://logos/{logo_id}`).
- **Social Media Templates**: Standardized layout schemas for LinkedIn, Instagram, X (Twitter), and YouTube OpenGraph cards (`brand://templates/{template_id}`).
- **Watermarking Tool**: Fast image watermarking tool (`watermark_image`) that embeds official corporate branding and metadata badges into any generated image or render.
- **100% Rebuildable**: Shareable via GitHub repository `ChrisTansey007/brand-asset-mcp`.
## Installation & Quick Start
```bash
git clone https://github.com/ChrisTansey007/brand-asset-mcp.git
cd brand-asset-mcp
uv sync
uv run python -m brand_asset_mcp.server
```
## MCP Tools & Resources
- **`brand://tokens`**: Get complete JSON design tokens (colors, fonts, radii, shadows).
- **`brand://templates`**: List all social media post templates.
- **`watermark_image`**: Apply brand logo watermark and metadata badge to an image file.
- **`get_brand_palette`**: Tool returning specific color themes (dark mode, coastal marine, engineering accent).
TDQS
B3.4/5.0
Scored across 3 tools
Disambiguation5/5
Each tool has a clearly distinct purpose: retrieving file paths, retrieving color palettes, and watermarking images. No overlap or ambiguity exists.
Naming Consistency5/5
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_brand_asset_paths), making them predictable and easy to understand.
Tool Count3/5
With only 3 tools, the server covers a narrow range of operations. While not excessive, it feels thin for a brand asset server, bordering on insufficient for broader needs.
Completeness2/5
Obvious gaps exist: the server lacks tools for uploading, updating, or deleting assets, and returns only file paths rather than actual asset data. Core lifecycle operations are missing.
Maintenance
ActivityStale
ResponsivenessNo issues