GodProfile MCP工具包
MCP服务器将您的GitHub配置文件README变成一个神级的艺术展览。 此README中的每一个可视化都是由GodProfile本身生成的。
      
不确定这是否值得?观看7个动画SVG实时运行——无需安装,无需注册。
将此服务器交给Claude Desktop,然后说: _“让我的GitHub个人资料成为上帝级。”_ 它提供了16个工具,可以生成glassmorphic SVG、动画横幅、实时数据小部件, bento网格布局和完整的GitHub Actions CI——所有这些都来自一个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实时预览 (不安装)→
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.简短版本:
- 选择一个未决问题或查看下面的路线图
- 将您的模块添加到
src/godprofile_mcp/core/ - 将其连接到
server.py和@mcp.tool() - 将deps保持为零(仅限stdlib)
- 打开PR——欢迎所有技能水平的人
路线图
- \[ \]
render_github_streak--SVG贡献条纹卡 - \[ \]
generate_skills_radar--技能雷达/蜘蛛图 - \[ \]
theme_editor--交互式主题代币定制器 - \[ \]
export_to_html--完整的独立HTML配置文件导出 - \[\]PyPI发布+版本发布
标记回购以跟踪进度。

