profilekit-mcp

ProfileKit用MCPサーバー。 Claude Code、Codex CLI、ChatGPT Apps、その他MCP対応エージェントから、会話を通じてGitHubプロフィールのSVGカードを作成できます。

MCPの利点

2025年後半にOpenAIとAnthropicが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とMarkdownスニペットを返します。

ツール

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) ツール — 1回の呼び出しでブログレイアウトのREADMEスニペット全体を返します

• v0.4 — オプションのSVGインライン化（マークアップを推論したいエージェントのために、カードコンテンツをレスポンスに取得）

• v1.0 — 呼び出し元のビジョン/LLM機能を活用したパレット提案ツール（組み込みのモデル呼び出しはなし）

ライセンス

MIT © heznpc