GitHubCard

GitHubCard MCP server

AI アシスタントが、最新の GitHub データを使って GitHubCard の画像を作成できるようにします。プロフィールカードやリポジトリカードを、README、リンクプレビュー、ソーシャル投稿に利用できます。

• ホスト型： https://githubcard.com/mcp（Streamable HTTP）。インストールは不要です。
• ローカル： ghcard CLI の npx -y @ghcardhq/ghcard mcp（stdio）。ディスク上の README を編集することもできます。

次のように依頼できます。

自分のプロフィール用に GitHubCard を作成して、README の先頭に追加してください。

vercel/next.js 用に、リンクプレビューで使えるダークなカードを作成してください。

コンパクトなリポジトリテンプレートを使い、背景色を #1e3a5f にして、言語ウィジェットは含めないでください。

API キーを取得する

カードの作成には無料の API キーが必要です。 githubcard.com/dashboard にサインインし、API keys から作成してください。キーは ghc_live_… のような形式です。

キーがなくても、サーバーではテンプレート、パレット、ウィジェットタイプの一覧を確認できるため、登録前に試すことができます。

セットアップ

以下の例では、ghc_live_… を自分のキーに置き換えてください。

Claude Code

claude mcp add --transport http githubcard https://githubcard.com/mcp \
  --header "Authorization: Bearer ghc_live_…"

サーバーと GitHubCard スキルを追加する Claude Code プラグインもあります。詳しくは ghcardhq/skills を参照してください。

Claude Desktop

Settings → Connectors → Add custom connector を選択し、URL に https://githubcard.com/mcp を指定します。ここではまだカスタムヘッダーを利用できないため、キーを渡すには、代わりに claude_desktop_config.json でローカルサーバーを使用してください。

{
  "mcpServers": {
    "githubcard": {
      "command": "npx",
      "args": ["-y", "@ghcardhq/ghcard", "mcp"],
      "env": { "GHCARD_API_KEY": "ghc_live_…" }
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "githubcard": {
      "url": "https://githubcard.com/mcp",
      "headers": { "Authorization": "Bearer ghc_live_…" }
    }
  }
}

VS Code

.vscode/mcp.json（VS Code ではキーの入力を一度求められ、安全に保存されます）：

{
  "inputs": [
    {
      "id": "githubcard-key",
      "type": "promptString",
      "description": "GitHubCard API key",
      "password": true
    }
  ],
  "servers": {
    "githubcard": {
      "type": "http",
      "url": "https://githubcard.com/mcp",
      "headers": { "Authorization": "Bearer ${input:githubcard-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "githubcard": {
      "serverUrl": "https://githubcard.com/mcp",
      "headers": { "Authorization": "Bearer ghc_live_…" }
    }
  }
}

Codex CLI

~/.codex/config.toml：

[mcp_servers.githubcard]
url = "https://githubcard.com/mcp"
bearer_token_env_var = "GHCARD_API_KEY"

続いて、シェルで GHCARD_API_KEY=ghc_live_… をエクスポートしてください。

その他のクライアント

リモート：https://githubcard.com/mcp の Streamable HTTP。ヘッダーは Authorization: Bearer ghc_live_… です。

ローカル（stdio）：コマンドは npx、引数は ["-y", "@ghcardhq/ghcard", "mcp"]、環境変数は GHCARD_API_KEY です。update_readme を有効にするには、引数に --allow-file-writes を追加してください。Node.js 20 以降が必要です。

ツール

ツール	キー	機能
create_card	必要	ユーザーまたは owner/repo のカードを作成（または再利用）します。SVG/PNG のリンクと、埋め込み用の Markdown/HTML スニペットを返します。1 日の利用枠を 1 単位消費します
validate_card	必要	create_card のドライランです。ID、Pro 機能、カスタムデザインを確認し、利用枠は消費しません
list_templates	不要	レイアウトの一覧です。スコープ（プロフィール／リポジトリ）、Free プラン、ウィジェットタイプで絞り込めます
list_palettes	不要	背景パレットの一覧です
list_components	不要	カードに含められるウィジェットタイプの一覧です
get_template_design	不要	テンプレートのレイアウトを編集可能なデザインドキュメントとして取得します
get_card_design	必要	自分のカードのデザインドキュメントを取得します
list_cards	必要	作成したカードの一覧です
delete_card	必要	カードを削除します。カードのリンクは機能しなくなります
get_usage	必要	プランと、今日の残り利用枠を確認します
update_readme	ローカルのみ	Markdown ファイル内のカードを挿入または更新します。ghcard mcp --allow-file-writes を使う場合に限ります

create_card は冪等です。同じ入力を渡すと、同じカードとリンクが返されます。カード画像には常に最新の GitHub データが表示されるため、カードを作り直す必要はありません。

失敗した呼び出しは、安定した code、retryable フラグ、モデルに次の対応を伝える hint とともに isError: true を返します。

制限

プラン	1 日あたりのカード数
Free	100
Pro	5000

利用枠は 00:00 UTC にリセットされます。失敗した呼び出しはカウントされません。Free カードには小さなウォーターマークが付きます。料金プランを参照してください。

リンク

• githubcard.com：エディターとギャラリー
• ghcardhq/ghcard：CLI とローカル MCP サーバー
• ghcardhq/skills：Claude Code プラグインとスキル
• server.json：MCP レジストリへの登録情報。登録名は com.githubcard/mcp

ライセンス

MIT