Godprofile

ターミナル SVG — render_terminal_emulator_svg

macOS ウィンドウの外観を備えた、タイプライター風のアニメーションターミナルです。すべての行が自動で入力されます。

アイコンマーキー — 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 で同期します。

アイソメトリック 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 キーも設定も登録も不要です。

または、ウィジェットを 1 つだけインラインで生成します。

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 を使って、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	Spotify API を OAuth トークンで呼び出し、現在再生中のトラックカードを描画します

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. 対応可能な未解決の Issue を選ぶか、以下のロードマップを確認します
2. src/godprofile_mcp/core/ にモジュールを追加します
3. @mcp.tool() を使って server.py に組み込みます
4. 依存関係はゼロ（標準ライブラリのみ）に保ちます
5. PR を作成します。スキルレベルは問いません

ロードマップ

• render_github_streak — SVG のコントリビューション連続記録カード
• generate_skills_radar — スキル用のレーダー／スパイダーチャート
• theme_editor — テーマトークンを対話的にカスタマイズするツール
• export_to_html — 完全にスタンドアロンな HTML プロフィールのエクスポート
• PyPI への公開とバージョン付きリリース

進捗を追うには、リポジトリにスターを付けてください。