Godprofile

终端 SVG — render_terminal_emulator_svg

带有 macOS 窗口装饰的打字机动画终端。每一行都会自动逐字显示。

图标滚动条 — generate_animated_icon_marquee

由 CSS 动画驱动、无限滚动的技术徽章条带。无缝循环，不使用 JavaScript。

神经网络图 — generate_neural_network_map

将你的技术栈呈现为由贝塞尔曲线连接的动态神经网络图。节点脉动，边线流动。

GitHub 奖杯 — render_github_trophies

自定义 SVG 奖杯陈列柜，设有 S/A/B/C 等级。S 级奖杯带有金色辉光动画。

## WakaTime 活动 — `render_wakatime_activity_chart`

展示每周编程语言占比的横向动画条形图。

Spotify 正在播放 — render_spotify_now_playing

带有动画均衡器条的品牌「正在播放」卡片。通过 GitHub Actions 定时任务同步。

等距 3D 地球 — render_3d_contribution_globe

运用真实的球面到等距投影数学。包含 12 条经线和 8 条纬线。缓慢旋转动画。

快速安装

# Option 1 — uvx (zero install, runs directly)
uvx godprofile-mcp

# Option 2 — pip
pip install godprofile-mcp

# Option 3 — dev mode
git clone https://github.com/Luc0-0/GodProfile
cd GodProfile
pip install -e ".[dev]"
python examples/quickstart.py   # generates all SVGs to examples/output/

如果它为你节省了时间，点个 ⭐ 就能帮助其他人发现它，只需 2 秒。

30 秒上手

无需 Claude Desktop。运行以下命令并打开输出文件夹：

git clone https://github.com/Luc0-0/GodProfile
cd GodProfile
pip install -e ".[dev]"
python examples/quickstart.py

这会在 examples/output/ 中生成 9 个实时 SVG。在浏览器中打开任意文件，即可立即查看动画效果。无需 API 密钥、无需配置、无需注册。

也可以直接生成单个组件：

from godprofile_mcp.core import terminal_emulator
svg = terminal_emulator.create_typing_svg(["$ whoami", "you"], "luxury-glass")
open("demo.svg", "w").write(svg)
# open demo.svg in any browser

在线预览（无需安装）→ luc0-0.github.io/GodProfile

MCP 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "godprofile": {
      "command": "uvx",
      "args": ["godprofile-mcp"]
    }
  }
}

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

重启 Claude Desktop，然后试试：

“使用 GodProfile，采用 luxury-glass 主题重建我的 README，添加展示技术栈的终端 SVG、WakaTime 编程统计数据和动画图标滚动条。”

16 个工具

渲染工具 — 传入自己的数据，获取 SVG

工具	生成内容
refactor_readme_to_bento	根据你的 Markdown 生成非对称 Bento 网格 HTML 布局
render_svg_widget	带有 12px 边框和主题令牌的玻璃拟态 SVG 统计卡片
generate_neural_network_map	由贝塞尔曲线连接的动画技术栈可视化图
setup_github_automation	用于自动同步统计数据的 GitHub Actions 工作流
render_spotify_now_playing	带有动画均衡器条的「正在播放」卡片（占位内容）
render_wakatime_activity_chart	根据提供的语言占比生成横向条形图
setup_contribution_snake	蛇形游戏吞噬你的贡献网格（可自定义主题）
render_3d_contribution_globe	使用真实经纬度投影数学生成等距 3D 地球
fetch_latest_blog_posts	RSS/Atom 订阅源 → 最新文章的样式化 SVG 卡片
render_terminal_emulator_svg	带有 macOS 窗口装饰的打字机动画终端
generate_animated_icon_marquee	由技术名称徽章组成的无限 CSS 滚动条
capture_animated_banner_gif	纯 SVG 动画横幅，带渐变和依次淡入效果
render_github_trophies	根据提供的统计数据字典生成奖杯陈列，排名分为 S/A/B/C 级

实时抓取工具 — 调用真实 API，获取实时 SVG

工具	获取内容
fetch_github_trophies_live	从 GitHub API 获取真实的星标、提交、PR、仓库和关注者数据，并渲染奖杯墙
fetch_wakatime_chart_live	使用你的密钥调用 WakaTime API → 渲染过去 7 天的语言图表
fetch_spotify_now_playing_live	使用 OAuth 令牌调用 Spotify API → 渲染当前曲目卡片

4 种主题

主题	风格	背景	点缀色
luxury-glass	暗色玻璃拟态，金色点缀	#0b0f14	#b6a891
terminal-hacker	黑底绿色矩阵终端	#000000	#00ff41
minimalist	简洁的 GitHub 原生浅色模式	#ffffff	#111827
cyberpunk	霓虹洋红／青色高对比度	#0d0221	#ff003c

架构

godprofile_mcp/
├── server.py        ← 13 FastMCP @mcp.tool() endpoints
├── resources.py     ← 4 themes as theme://{name} MCP resources
├── prompts.py       ← Aesthetic design guide injected at generation time
└── core/
    ├── bento_layout.py          ← Asymmetric HTML table grid
    ├── svg_rendering.py         ← Glassmorphic SVG card engine
    ├── neural_bezier_engine.py  ← Bezier-connected tech stack map
    ├── github_ci_automation.py  ← GitHub Actions YAML generator
    ├── snake_game_injector.py   ← Contribution snake setup
    ├── blog_fetcher.py          ← RSS/Atom feed → SVG post card
    ├── terminal_emulator.py     ← Animated typewriter terminal SVG
    ├── icon_marquee.py          ← CSS infinite-scroll marquee SVG
    ├── animated_banner.py       ← Gradient animated banner SVG
    ├── github_trophies.py       ← Trophy case SVG with tier logic
    ├── spotify_now_playing.py   ← Spotify UI card + cron workflow
    ├── wakatime_metrics.py      ← Coding stats horizontal bar chart
    └── isometric_3d_globe.py   ← 3D isometric globe SVG

设计原则：

• 除 mcp 和 pydantic 外，不依赖任何外部库——所有 SVG 生成都使用标准库
• 自包含的内联 SVG（无 CDN，渲染时不发起外部请求）
• 确定性输出——相同输入始终生成相同的 SVG

为什么不使用个人资料生成网站？

	GodProfile	静态生成器	手动编辑
对话式 AI 驱动	✅	❌	❌
完全动画化的 SVG	✅	部分支持	❌
实时数据（Spotify、WakaTime）	✅	部分支持	❌
GitHub Actions 自动化	✅	❌	手动
不受供应商锁定	✅	❌	✅
离线可用／无需 API 密钥	✅	❌	✅
可自定义主题	✅	有限支持	✅

参与贡献

请参阅 CONTRIBUTING.md。简要步骤如下：

1. 选择一个未解决的问题，或查看下方的路线图
2. 将你的模块添加到 src/godprofile_mcp/core/
3. 在 server.py 中使用 @mcp.tool() 将其接入
4. 保持零依赖（仅使用标准库）
5. 提交 PR——欢迎所有技能水平的贡献者

路线图

• render_github_streak — SVG 贡献连续记录卡片
• generate_skills_radar — 技能雷达图／蛛网图
• theme_editor — 交互式主题令牌自定义工具
• export_to_html — 导出完整的独立 HTML 个人资料
• 发布到 PyPI + 发布带版本号的版本

给仓库点星以跟进进展。