hirotomasato/yowes
一、一句话定位
Yowes 是一个基于 MCP 协议的无头服务器，能通过 AI 代理调用自动生成 13 个国家的教师验证文档（聘用信、教师证、薪资单等）。
二、核心技术/架构亮点
- MCP over stdio：以标准 MCP 工具接口暴露文档生成能力，天然适配 Claude Desktop、Hermes 等代理运行时。
- 多国模板引擎：13 个独立国家包，每个包含当地文档类型和真实学校数据库。
- 自包含部署：代码、DejaVu 字体、头像照片池全部打包进 Python wheel，免系统依赖。
- Pillow 渲染：生成高分辨率 PNG，支持性别感知的头像选择。
三、适用场景与目标用户
- 教育行政自动化：学校批量生成教职员工资质文件。
- AI 代理开发者：为聊天机器人或 workflow 添加文档生成技能。
- 需要多国格式支持的项目：快速扩展新国家文档模板。
四、可动手动作
1. 本地运行：`git clone` → `pip install -e .` → `yowes-mcp` 启动服务器。
2. 集成到代理：在 MCP 客户端配置中注册 `yowes-mcp` 命令，即可通过 `generate_documents` 工具生成文档。
3. 借鉴思路：利用 `countries/` 下各国家包的 `base.py` 抽象基类，可仿照添加新国家文档类型。
五、学习优先级
P1（排期） — 非核心基础设施，但可作为 MCP 服务开发的有趣范例，适合后续深入研究。
六、主题标签
文档生成⌂