15 v0.2.1 更新于 2026-11-01

GitHubCard MCP Server

为 README、链接预览和社交帖子创建 GitHub 个人主页与仓库卡片。

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
远程接入
任意支持远程 MCP(streamable-http)的客户端,如 Claude、ChatGPT 开发者模式、自建 Agent

安装配置

本地运行(npm)
{
  "mcpServers": {
    "mcp-7a9f88": {
      "command": "npx",
      "args": [
        "-y",
        "@ghcardhq/ghcard"
      ]
    }
  }
}
远程接入(streamable-http)
{
  "mcpServers": {
    "mcp-7a9f88": {
      "url": "https://githubcard.com/mcp"
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 11 个工具

create_card
为用户或仓库创建(或复用)卡片,返回 SVG/PNG 链接和 Markdown/HTML 嵌入代码,占用每日配额。
validate_card
create_card 的干运行,检查 ID、Pro 功能和自定义设计,不消耗配额。
list_templates
列出卡片模板布局,可按范围(profile/repo)、Free 计划和组件类型过滤。
list_palettes
列出可用的背景调色板。
list_components
列出卡片可包含的组件(widget)类型。
get_template_design
获取模板的布局,作为可编辑的设计文档。
get_card_design
获取你某个卡片的设计文档。
list_cards
列出你已创建的卡片。
delete_card
删除卡片,其链接随之失效。
get_usage
查看你的计划和当日剩余配额。
update_readme
在本地 Markdown 文件中插入或更新卡片,仅在启用 --allow-file-writes 的本地模式下可用。