悉尼大学色彩MCP服务器
一个模型上下文协议（MCP）服务器，为悉尼大学的教职工和学生提供官方色彩调色板的程序化访问。
特点/功能
- 官方品牌颜色访问悉尼大学（USYD）官方的一级、二级和三级色彩调色板
- 扩展颜色与官方色板和谐搭配的互补色
- 多种输出格式获取HEX、RGB和CSS格式的颜色
- 智能搜索按名称或十六进制颜色搜索颜色
- CSS 世代自动生成CSS自定义属性
- 使用指南内置品牌标识和无障碍性指南
安装
先决条件
- Python 3.10或更高版本
- 紫外线 包管理器
安装uv
如果你没有 uv 已安装：
# On macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"设置服务器
- 克隆或下载此仓库：
mkdir -p ~/Documents/projects/usyd-colours-mcp
cd ~/Documents/projects/usyd-colours-mcp- 创建项目文件：
保存 usyd-colours.py （服务器代码）放到这个目录中。
- 创建
pyproject.toml:
[project]
name = "usyd-colours-mcp"
version = "1.0.0"
description = "MCP server for University of Sydney official colours"
dependencies = [
"mcp>=0.9.0",
]
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"- 安装依赖项：
uv sync配置
Claude Desktop（可译为“Claude桌面版”或保持原样，具体根据语境决定是否需要意译）
将此添加到您的Claude桌面配置文件中：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"usyd-colours": {
"command": "/Users/YOUR_USERNAME/.local/bin/uv",
"args": [
"--directory",
"/Users/YOUR_USERNAME/Documents/projects/usyd-colours-mcp",
"run",
"usyd-colours.py"
]
}
}
}重要的替换 YOUR_USERNAME 使用你真实的用户名！
找到你的 uv 路径：
which uv其他MCP客户端
服务器使用stdio传输方式，可以与任何MCP兼容的客户端一起使用。请根据您客户端的文档进行配置。
使用方法
配置完成后，您可以通过您的MCP客户端（如Claude Desktop）与服务器进行交互。以下是一些查询示例：
寻找色彩
"What's the hex code for USYD ochre?"
"Show me the Heritage Rose colour"
"Find colours matching '#E74726'"获取色彩搭配方案
"Show me the official USYD primary colours"
"What are the tertiary/heritage colours?"
"Give me all the official brand colours"
"What extended warm colours are available?"生成CSS
"Generate CSS variables for the official USYD colours"
"Create CSS custom properties including extended colours"获取指南
"Show me the colour usage guidelines"
"How should I use USYD colours in my design?"可用工具
服务器提供以下工具：
- 获取颜色通过名称或十六进制代码搜索特定颜色
- 获取官方颜色获取所有官方的悉尼大学（USYD）品牌颜色
- 获取扩展颜色获取互补/扩展颜色
- 获取调色板获取特定的调色板类型（主色、辅助色、第三色等）
- 列出所有颜色列出所有可用颜色
- 生成CSS生成CSS自定义属性
颜色类别
官方配色
原色 （来自官方风格指南）：
- 赭石色（#E74726）——悉尼大学（USYD）的标志性颜色
- 白色（#FFFFFF）
- 黑色（#000000）
- 浅灰色（#E6E7E9）
- 木炭（#424143）
次要颜色:
- 砂岩（#FBEEE2）
三级/传统色彩：
- 传承玫瑰色（#DAA8A2）
- 紫藤（#8F9EC8）
- 海军蓝（#1B355E）
- 桉树色（#71A499）
扩展颜色
互补色组合为：
- 中性色额外的灰色调
- 温暖橙子、桃子、土色调
- 太酷了！蓝灰色、天青色、绿色
- 充满活力的明亮的点缀色
发展
项目结构
usyd-colours-mcp/
├── usyd-colours.py # Main server code
├── pyproject.toml # Project dependencies
└── README.md # This file测试
您可以直接测试服务器：
cd ~/Documents/projects/usyd-colours-mcp
uv run usyd-colours.py服务器应启动并等待在标准输入（stdin）上接收MCP协议消息。
调试
如果服务器无法正常工作：
- 检查日志 在 Claude Desktop 中（帮助 > 查看日志）
- 验证UV路径：
which uv- 直接测试Python脚本：
python3 usyd-colours.py- 检查依赖项：
uv sync资源
- 新南威尔士大学（USYD）官方品牌指南 - 联系市场营销与传播部门
- USYDColors R 包 - R语言实现
- MCP 文档
- MCP Python SDK（MCP Python软件开发工具包）
许可证
此服务器仅供悉尼大学教职工和学生使用。颜色规格为悉尼大学所有。
做出贡献
如需报告问题或提出改进建议，请联系悉尼信息中心或在代码库中创建一个问题。
致谢
- 悉尼信息学中心的原始R语言包
- 悉尼大学市场营销与传播部关于官方颜色规范
- 为模型上下文协议设计的人类中心主义（或“以人为本”的）方法
______________________________________________________________________
由……维护信息与通信技术（ICT） 最后更新时间2025年10月21日