DocGenius 是一个基于模型上下文协议（MCP）的智能服务，能够接收用户的自然语言指令和文本内容，自主选择合适的文档模板，将文本内容渲染成设计精美的HTML，并输出为图片。
card-creator-mcp/
├── templates/ # 模板文件目录
│ ├── resume.md # 简历模板
│ └── knowledge_card.md # 知识卡片模板
├── pic/ # 输出图片目录（自动创建）
├── main_service.py # 主服务文件
├── requirements.txt # 项目依赖
└── README.md # 项目文档
无需本地安装，直接运行最新版本：
# 直接运行服务
uvx docgenius-service
# 或使用简化命令
uvx --from docgenius-service docgenius
# 安装到本地环境
pip install docgenius-service
# 运行服务
docgenius-service
# 或
docgenius
如果你需要修改源码：
git clone <repository-url>
cd docgenius-service
pip install -e .
docgenius-service # 首次运行会自动安装Chromium浏览器
DocGenius 支持通过环境变量进行配置：
DOCGENIUS_TEMPLATES_DIR: 自定义模板文件夹路径（可选）设置方式：
使用 .env 文件（推荐）：
# 在当前目录创建 .env 文件
echo "DOCGENIUS_TEMPLATES_DIR=/path/to/your/templates" > .env
docgenius-service
命令行设置：
# Windows PowerShell
$env:DOCGENIUS_TEMPLATES_DIR="D:\path\to\templates" ; docgenius-service
# Linux/macOS
DOCGENIUS_TEMPLATES_DIR=/path/to/templates docgenius-service
如果你使用 MCP 客户端（如 Claude Desktop），可以在 mcp.json 中配置：
{
"mcpServers": {
"docgenius": {
"command": "uvx",
"args": ["docgenius-service"],
"env": {
"DOCGENIUS_TEMPLATES_DIR": "/path/to/your/custom/templates"
}
}
}
}
或者使用本地安装的版本：
{
"mcpServers": {
"docgenius": {
"command": "docgenius-service",
"env": {
"DOCGENIUS_TEMPLATES_DIR": "/path/to/your/custom/templates"
}
}
}
}
列出所有可用的文档模板。
返回: 包含模板名称和描述的列表
获取指定模板的详细信息，包括元数据和提示词。
参数:
template_name: 模板名称返回: 包含模板详细信息的字典
将HTML内容保存为本地文件。
参数:
html_content: HTML代码字符串template_name: 使用的模板名称file_name: 输出文件名（不含扩展名）返回: 保存的HTML文件的绝对路径
读取本地HTML文件并将其渲染为JPG图片。
参数:
html_file_path: HTML文件的路径width: 图片宽度height: 图片高度返回: 生成的JPG图片文件的绝对路径
模板文件采用Markdown格式，包含YAML Frontmatter：
---
description: "模板描述"
width: 800
height: 600
---
这里是提示词内容，使用 {user_text} 作为用户输入的占位符。
# 1. 列出可用模板
templates = await client.call_tool("list_available_templates")
# 2. 获取模板详情
details = await client.call_tool("get_template_details", {"template_name": "resume"})
# 3. 保存HTML文件
html_path = await client.call_tool("save_html_file", {
"html_content": "<html>...</html>",
"template_name": "resume",
"file_name": "my_resume"
})
# 4. 生成图片
image_path = await client.call_tool("create_image_from_html_file", {
"html_file_path": html_path,
"width": 827,
"height": 1169
})
运行服务后，文件将保存在当前工作目录的 pic/ 文件夹中，按模板类型自动分类：
当前目录/
├── pic/
│ ├── resume/
│ │ ├── my_resume.html
│ │ └── my_resume.jpg
│ └── knowledge_card/
│ ├── my_card.html
│ └── my_card.jpg
该项目目前处于 2.0.3 版本，具备以下特性：
uvx 一键运行更新日志：
本项目采用MIT许可证开源。
FAQs
一个AI驱动的动态文档生成服务，可将文本转换为设计精美的图片。
We found that docgenius-service demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Undocumented protestware found in 28 npm packages disrupts UI for Russian-language users visiting Russian and Belarusian domains.
Research
/Security News
North Korean threat actors deploy 67 malicious npm packages using the newly discovered XORIndex malware loader.
Security News
Meet Socket at Black Hat & DEF CON 2025 for 1:1s, insider security talks at Allegiant Stadium, and a private dinner with top minds in software supply chain security.