Resume Onepage Autofit MCP

AI简历自动匹配系统

🌐 中文 |英语

  

🤖 厌倦了在AI和Word之间复制、调整格式和调整以适应一页？如果人工智能可以为你处理这个反馈循环呢？此MCP允许AI渲染PDF并自动调整内容，以完美地适应一个具有干净格式的页面。

🎯 运作原理

User: Please generate a single-page resume from my experience

AI Agent:
1. 📝 Generate initial Markdown
2. 🔍 Call render_resume_pdf to validate
3. ⚠️ Detected 12% overflow
4. 🔧 Apply Level 2 reduction strategy
5. ✅ Success! PDF generated

🚀 快速开始

1.安装MCP服务器

# Enter MCP Server directory and install dependencies
cd mcp_server
pip install -r requirements.txt
# ⚡ Or using uv (recommended): uv pip install -r requirements.txt

# Install Chromium browser (first time only, ~150MB)
playwright install chromium

2.配置克劳德桌面

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "resume-onepage-autofit-mcp": {
      "command": "python",
      "args": ["/myresumebuilder/mcp_server/mcp_server.py"]
    }
  }
}

替换 ` 根据您的实际项目路径。 ⚡ **如果您更喜欢使用 [紫外线](https://github.com/astral-sh/uv)**: `json "resume-onepage-autofit-mcp": { "command": "uv", "args": [ "run", "--directory", "/myresumebuilder", "mcp_server/mcp_server.py" ] } ``

3.准备简历内容

将简历内容写在 myexperience.md （参见 example_resume.md 格式）。

4.开始使用

重启Claude Desktop，然后简单地告诉AI：“请根据我的经验生成一份单页简历”

生成的PDF保存到 generated_resume/ 默认情况下，项目目录中的文件夹。

💡 自定义输出路径: - （可选）创建 js/config.js 从以下位置覆盖设置 js/config.defaults.js （例如。 pdfOutput 路径） - 或指定 output_path 调用以保存到任何位置时的参数

______________________________________________________________________

✨ 核心功能

• 🎯 智能配件：自动调整内容，使简历完美地放在一张A4纸上
• 🔍 精确检测：基于Playwright的像素精确页面高度检测
• 📊 分层缩减：三层缩减策略（格式优化→ 内容简化→ 深度还原）
• 🔄 反馈回路：AI Agent根据溢出指标智能迭代
• 🚀 MCP集成：支持来自Claude Desktop和其他AI客户端的直接呼叫

📸 工作流程

User provides experience → AI generates Markdown resume
                                    ↓
                        MCP Server renders & validates
                                    ↓
                    ┌─────── Detect page height ───────┐
                    │                                  │
                  Success                           Failure
               (within one page)                 (overflow X%)
                    │                                  │
              Generate PDF                  Return overflow metrics + hints
                    │                                  ↓
                    │                       AI applies reduction strategy
                    │                           (Level 1/2/3)
                    │                                  │
                    └──────────── Re-render ←──────────┘

🎨 减排战略概述

看 AI_AGENT_PROMPT.md 详细的战略。

🔧 视觉预览（可选）

要手动调整默认样式参数，请使用控制面板（纯前端，不需要Python）：

# Use VS Code Live Server extension (recommended)
# Right-click control_panel.html -> "Open with Live Server"

# Or Python simple server
python -m http.server 8080
# Visit http://localhost:8080/control_panel.html

💡 控制面板主要用于手动调试样式限制（例如字体大小范围、行距）。对于日常使用，请依赖AI Agent，它会根据内容在最佳范围内自动调整布局。有关技术详细信息，请参阅 Developpent.md.

📚 文档

• AI_AGENT_PROMPT.md：AI Agent核心缩减策略（必读）
• Developpent.md：技术架构和开发指南
• mcp_server/README.md：MCP服务器API文档

🐛 已知限制

1. 浏览器依赖性：需要Chromium（首次约150MB）
2. 内容长度：很长的简历（10页以上）可能需要多轮缩减
3. 特殊字符：某些表情符号可能会影响布局

🔄 发展路线图

v0.2.0（计划中）

• \[\]自定义模板

🤝 贡献

问题和拉取请求欢迎！

开发设置

# Clone repository
git clone https://github.com/seriserendipia/resume-onepage-autofit-mcp.git
cd resume-onepage-autofit-mcp

# Create virtual environment
conda create -n agent_env python=3.10
conda activate agent_env

# Install dependencies
pip install -r mcp_server/requirements.txt
playwright install chromium

承诺公约

• feat: 新功能
• fix: 错误修复
• docs: 文档更新
• test: 测试相关

📄 许可证

MIT许可证-请参阅 许可证

🙏 致谢

• 剧作家 -强大的浏览器自动化
• 主控程序 -统一的AI工具协议
• Markdown它 -可靠的Markdown解析器
• Paged.js -浏览器中的PDF分页

📧 联系

• 🐛 问题：
• 💬 讨论：

______________________________________________________________________

⭐ 如果这个项目对你有帮助，请给它一颗星！

⭐ 如果这个项目对你有帮助，请给一个 Star！