profilekit-mcp

MCP-Server für ProfileKit. Erstellen Sie GitHub-Profil-SVG-Karten durch Konversation — von Claude Code, Codex CLI, ChatGPT Apps oder jedem anderen MCP-fähigen Agenten aus.

Warum MCP

Seit OpenAI und Anthropic Ende 2025 gemeinsam MCP Apps angekündigt haben, deckt ein einziger MCP-Server Claude Code + Codex CLI + ChatGPT nativ ab. Keine plattformspezifischen Adapter erforderlich.

Related MCP server: GitHub MCP Server

Installation

npm install -g @heznpc/profilekit-mcp

Bei Ihrem Agenten registrieren

Claude Code — fügen Sie dies zu .claude/settings.json in Ihrem Repository hinzu:

{
  "mcpServers": {
    "profilekit": { "command": "profilekit-mcp" }
  }
}

Codex CLI — fügen Sie dies zu ~/.codex/config.toml hinzu:

[mcp_servers.profilekit]
command = "profilekit-mcp"

ChatGPT Apps — (Apps SDK MCP-Adapter; siehe die Apps SDK-Dokumentation für die Einrichtung)

Verwendung

Fragen Sie innerhalb eines registrierten Agenten einfach:

> What ProfileKit cards exist?
> Render a tokyo_night stats card for heznpc.
> Give me a hero banner saying "heznpc" with subtitle "Building the ecosystem AI lives in", wave background, space-grotesk font.
> Build a kanagawa-themed pin card for heznpc/ProfileKit.

Der Agent ruft im Hintergrund list_cards / list_themes / render auf und gibt Ihnen eine URL sowie ein Markdown-Snippet zurück, das Sie direkt in Ihre README einfügen können.

Tools

render ruft das SVG nicht ab. Es gibt die URL und Snippets zurück, damit Sie das Live-Bild überall dort einbetten können, wo externe <img>-Tags erlaubt sind (GitHub README, dev.to, Hashnode, Notion-Cover, Folien-Cover).

Beispielkonversation

You: Render a pin card for heznpc/anvil using the rose_pine theme.

Agent: [calls render(type="pin", params={username: "heznpc", repo: "anvil", theme: "rose_pine"})]

URL:
https://profilekit.vercel.app/api/pin?username=heznpc&repo=anvil&theme=rose_pine

Markdown:
![pin](https://profilekit.vercel.app/api/pin?username=heznpc&repo=anvil&theme=rose_pine)

HTML:
<img src="https://profilekit.vercel.app/api/pin?username=heznpc&repo=anvil&theme=rose_pine" alt="pin" />

Roadmap

• v0.2 — Dynamische Katalog-Synchronisierung über einen ProfileKit /api/catalog-Endpunkt (automatische Updates, wenn neue Karten veröffentlicht werden)

• v0.3 — compose_readme(sections)-Tool — gibt ein vollständiges README-Snippet im Blog-Layout mit einem Aufruf zurück

• v0.4 — Optionales SVG-Inlining (Abrufen des Karteninhalts in die Antwort) für Agenten, die das Markup analysieren möchten

• v1.0 — Tool für Palettenvorschläge, unterstützt durch die eigene Vision/LLM-Fähigkeit des Aufrufers (keine integrierten Modellaufrufe)

Lizenz

MIT © heznpc