GitHubCard

GitHubCard MCP 服务

让 AI 助手创建 GitHubCard 图片：适用于 README、链接预览和社交帖文的个人资料卡片和仓库卡片，数据来自实时 GitHub。

• 托管版： 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_…"

此外，还有一个 Claude Code 插件，会同时添加服务和 GitHubCard 技能：请参阅 ghcardhq/skills。

Claude Desktop

设置 → 连接器 → 添加自定义连接器，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"

然后在 shell 中导出 GHCARD_API_KEY=ghc_live_…。

其他客户端

远程：使用 https://githubcard.com/mcp 上的 Streamable HTTP，请求头为 Authorization: Bearer ghc_live_…。

本地（stdio）：命令为 npx，参数为 ["-y", "@ghcardhq/ghcard", "mcp"]，环境变量为 GHCARD_API_KEY。在参数中添加 --allow-file-writes 以启用 update_readme。需要 Node.js 20 或更高版本。

工具

工具	需要密钥	功能
create_card	是	为用户或 owner/repo 创建（或复用）卡片。返回 SVG/PNG 链接以及 Markdown/HTML 嵌入代码片段。消耗每日配额中的 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 数据，因此无需重新创建。

失败的调用会返回 isError: true，其中包含稳定的 code、retryable 标志，以及告知模型下一步操作的 hint。

限额

计划	每日卡片数
Free	100
Pro	5000

配额于 UTC 时间 00:00 重置。失败的调用不计入配额。Free 卡片带有小型水印。请参阅定价。

链接

• githubcard.com：编辑器和图库
• ghcardhq/ghcard：CLI 和本地 MCP 服务
• ghcardhq/skills：Claude Code 插件和技能
• server.json：在 MCP 注册表中的条目，名称为 com.githubcard/mcp

许可证

MIT