profilekit-mcp

ProfileKit용 MCP 서버. Claude Code, Codex CLI, ChatGPT 앱 또는 기타 MCP 지원 에이전트를 통해 대화를 나누며 GitHub 프로필 SVG 카드를 빌드하세요.

MCP를 사용하는 이유

OpenAI와 Anthropic이 2025년 말 MCP Apps를 공동 발표한 이후, 단일 MCP 서버로 Claude Code + Codex CLI + ChatGPT를 기본적으로 지원하게 되었습니다. 플랫폼별 어댑터가 필요 없습니다.

Related MCP server: GitHub MCP Server

설치

npm install -g @heznpc/profilekit-mcp

에이전트에 등록

Claude Code — 저장소의 .claude/settings.json에 추가:

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

Codex CLI — ~/.codex/config.toml에 추가:

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

ChatGPT Apps — (Apps SDK MCP 어댑터; 연결 방법은 Apps SDK 문서 참조)

사용법

등록된 에이전트 내에서 다음과 같이 요청하세요:

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

에이전트가 내부적으로 list_cards / list_themes / render를 호출하여 README에 바로 붙여넣을 수 있는 URL과 마크다운 스니펫을 제공합니다.

도구

render는 SVG를 직접 가져오지 않습니다. 외부 <img> 태그가 허용되는 곳(GitHub README, dev.to, Hashnode, Notion 커버, 슬라이드 커버 등)에 라이브 이미지를 삽입할 수 있도록 URL과 스니펫을 반환합니다.

대화 예시

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

로드맵

• v0.2 — ProfileKit /api/catalog 엔드포인트로부터의 동적 카탈로그 동기화 (새 카드가 출시될 때 즉시 업데이트)

• v0.3 — compose_readme(sections) 도구 — 한 번의 호출로 전체 블로그 레이아웃의 README 스니펫 반환

• v0.4 — 선택적 SVG 인라인 처리 (마크업을 분석하려는 에이전트를 위해 카드 콘텐츠를 응답으로 가져오기)

• v1.0 — 호출자의 비전/LLM 기능을 활용한 팔레트 제안 도구 (내장 모델 호출 없음)

라이선스

MIT © heznpc