profilekit-mcp

Servidor MCP para ProfileKit. Crea tarjetas SVG de perfil de GitHub a través de una conversación, desde Claude Code, Codex CLI, aplicaciones de ChatGPT o cualquier otro agente compatible con MCP.

Por qué MCP

Desde que OpenAI y Anthropic anunciaron conjuntamente MCP Apps a finales de 2025, un único servidor MCP cubre Claude Code + Codex CLI + ChatGPT de forma nativa. Sin adaptadores por plataforma.

Related MCP server: GitHub MCP Server

Instalación

npm install -g @heznpc/profilekit-mcp

Registrar con tu agente

Claude Code — añadir a .claude/settings.json en tu repositorio:

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

Codex CLI — añadir a ~/.codex/config.toml:

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

Aplicaciones de ChatGPT — (Adaptador MCP del SDK de aplicaciones; consulta la documentación del SDK de aplicaciones para la configuración)

Uso

Dentro de cualquier agente registrado, simplemente pregunta:

> 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.

El agente invocará list_cards / list_themes / render internamente y te devolverá una URL + un fragmento de markdown listo para pegar en tu README.

Herramientas

render no obtiene el SVG. Devuelve la URL y los fragmentos para que puedas incrustar la imagen en vivo donde se permitan etiquetas <img> externas (README de GitHub, dev.to, Hashnode, portada de Notion, portada de diapositivas).

Ejemplo de conversación

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" />

Hoja de ruta

• v0.2 — Sincronización dinámica del catálogo desde un endpoint /api/catalog de ProfileKit (actualizaciones automáticas cuando se lancen nuevas tarjetas)

• v0.3 — Herramienta compose_readme(sections) — devuelve un fragmento de README con diseño de blog completo en una sola llamada

• v0.4 — Inclusión opcional de SVG (obtener el contenido de la tarjeta en la respuesta) para agentes que deseen razonar sobre el marcado

• v1.0 — Herramienta de sugerencia de paleta respaldada por la propia capacidad de visión/LLM del llamador (sin llamadas a modelos integradas)

Licencia

MIT © heznpc