AI导哈

GitHub个人资料美化工具

一个通过MCP协议将GitHub个人资料README转化为高级视觉展示的工具集，提供16种SVG生成工具和4种主题风格。

  • by Luc0-0
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 Luc0-0/GodProfile

使用说明


GodProfile MCP工具包

MCP服务器将您的GitHub配置文件README变成一个神级的艺术展览。 此README中的每一个可视化都是由GodProfile本身生成的。


不确定这是否值得？观看7个动画SVG实时运行——无需安装，无需注册。



将此服务器交给Claude Desktop，然后说： “让我的GitHub个人资料成为上帝级。” 它提供了16个工具，可以生成glassmorphic SVG、动画横幅、实时数据小部件， bento网格布局和完整的GitHub Actions CI——所有这些都来自一个MCP配置行。

快速安装 · 工具 · 主题 · MCP配置 · 贡献

终端SVG-- render_terminal_emulator_svg

带有macOS窗口chrome的动画打字机终端。每条线都会自动输入。

图标选框-- generate_animated_icon_marquee

无限滚动的CSS技术徽章动画带。无缝循环，零JavaScript。

神经网络图-- generate_neural_network_map

你的技术栈是一个贝塞尔连接的动画神经图。节点脉动，边缘流动。

GitHub奖杯-- render_github_trophies

带有S/A/B/C等级等级的定制SVG奖杯案例。S级奖杯闪耀着金色的光芒。

WakaTime活动-- render_wakatime_activity_chart

每周编码语言分解的动画水平条形图。

Spotify正在播放-- render_spotify_now_playing

带有动画均衡器条的“正在玩”牌。通过GitHub Actions cron进行同步。

等距三维球体-- 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秒后试试

不需要克劳德桌面。运行此命令并打开输出文件夹：

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

这会产生 9 现场 SVG 进入 examples/output/ --在浏览器中打开任何文件，立即查看动画输出。没有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 窗户： %APPDATA%\Claude\claude_desktop_config.json

重新启动Claude Desktop，然后尝试：

“使用GodProfile用豪华玻璃主题、显示堆栈的终端SVG、WakaTime编码统计数据和动画图标框重建我的README。”

16工具

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

工具 它生成什么
refactor_readme_to_bento Markdown中的非对称便当网格HTML布局
render_svg_widget Glassmorphic SVG统计卡，带12像素边框+主题标记
generate_neural_network_map 动画贝塞尔连接技术堆栈可视化
setup_github_automation 用于自动统计同步的GitHub操作工作流
render_spotify_now_playing 带有动画均衡器条（占位符）的“正在播放”卡
render_wakatime_activity_chart 所提供语言百分比的水平条形图
setup_contribution_snake 蛇游戏吃你的贡献网格（自定义主题）
render_3d_contribution_globe 使用实经纬投影数学的等距三维地球仪
fetch_latest_blog_posts RSS/Atom订阅源→ 最新帖子的SVG风格卡片
render_terminal_emulator_svg 带有macOS窗口chrome的动画打字机终端
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获取真正的明星/提交/PRs/reso/追随者，呈现奖杯案例
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生成都使用stdlib
  • 自包含的内联SVG（无CDN，渲染时无外部请求）
  • 确定性输出——相同的输入总是产生相同的SVG

为什么不是一个个人资料生成器网站？

GodProfile 静态生成器 手动编辑
对话式AI驱动 ✅ ❌ ❌
全动画SVG ✅ 部分 ❌
实时数据（Spotify、WakaTime） ✅ 一些 ❌
GitHub操作自动化 ✅ ❌ 手册
零供应商锁定 ✅ ❌ ✅
脱机工作/不需要API密钥 ✅ ❌ ✅
可定制主题 ✅ 有限 ✅

贡献

看 贡献.md.简短版本：

  1. 选择一个未决问题或查看下面的路线图
  2. 将您的模块添加到 src/godprofile_mcp/core/
  3. 将其连接到 server.py 和 @mcp.tool()
  4. 将deps保持为零（仅限stdlib）
  5. 打开PR——欢迎所有技能水平的人

路线图

  • [ ] render_github_streak --SVG贡献条纹卡
  • [ ] generate_skills_radar --技能雷达/蜘蛛图
  • [ ] theme_editor --交互式主题代币定制器
  • [ ] export_to_html --完整的独立HTML配置文件导出
  • []PyPI发布+版本发布

标记回购以跟踪进度。

内置于 FastMCP ·协议由 人类 ·MIT许可证

相关 MCP