capcard (Capability Index)

capcard

capcard 是用于生成、验证和发布能力卡的开源CLI。

能力卡是一种机器可读的JSON文档，发布于 /.well-known/capability-card.json 因此，代理可以发现API和MCP服务器。

公共回购： https://github.com/Capability-Index/capcard

你能用它做什么

• 从OpenAPI规范或MCP清单生成能力卡
• 使用Anthropic、OpenAI、Gemini或确定性无密钥生成
• 根据公共模式验证卡
• 将其发布到可部署 /.well-known/ 路径
• 将其托管在GitHub Pages、Vercel、Netlify、Cloudflare Pages或任何静态服务器上

安装

pip install capcard

capcard 需要Python 3.11+.

如果 pip 不在shell PATH中，请使用：

python3.11 -m pip install capcard

60秒快速入门

Fewest点击

capcard init https://example.com/openapi.yaml --provider auto
capcard validate capability-card.json
capcard publish capability-card.json --target github-pages --site-dir .

这给了你：

• capability-card.json
• ./.well-known/capability-card.json
• ./.nojekyll
• ./index.html 如果还不存在

发电模式

1.自动选择提供商

如果这些密钥之一存在， capcard 将自动使用它：

• ANTHROPIC_API_KEY
• OPENAI_API_KEY
• GEMINI_API_KEY

export OPENAI_API_KEY=your_key_here
capcard enrich https://example.com/openapi.yaml --provider auto --output capability-card.json

2.明确的提供者选择

capcard enrich https://example.com/openapi.yaml --provider anthropic --output capability-card.json
capcard enrich https://example.com/openapi.yaml --provider openai --output capability-card.json
capcard enrich https://example.com/openapi.yaml --provider gemini --output capability-card.json

3.确定性无密钥模式

如果您不想使用LLM提供程序，或者还没有API密钥：

capcard enrich https://example.com/openapi.yaml --provider deterministic --output capability-card.json

这将仅从规范元数据中生成有效的启动能力卡。

命令

capcard init

创建启动器 capability-card.json 并可选择发布它。

capcard init https://example.com/openapi.yaml
capcard init https://example.com/openapi.yaml --provider deterministic
capcard init https://example.com/openapi.yaml --publish-target vercel --site-dir ./public

capcard enrich

在不发布的情况下生成能力卡。

capcard enrich ./openapi.yaml --provider auto --output capability-card.json
capcard enrich ./mcp-manifest.json --provider deterministic --pretty

capcard validate

验证本地能力卡JSON文件。

capcard validate capability-card.json

capcard publish

将经过验证的卡复制到可部署的 /.well-known/ 路径。

capcard publish capability-card.json --target static-dir --site-dir ./public
capcard publish capability-card.json --target github-pages --site-dir .
capcard publish capability-card.json --target vercel --site-dir ./public
capcard publish capability-card.json --target netlify --site-dir ./dist
capcard publish capability-card.json --target cloudflare-pages --site-dir ./dist

托管指南

• docs/QUICKSTART.md
• docs/PUBLISH_VERCEL.md
• docs/PUBLISH_NETLIFE.md
• docs/PUBLISH_CLOUDFLARE_PAGES.md
• docs/SCHEMA.md
• docs/兼容性.md

公共回购发布模式

规范的公共仓库是：

• https://github.com/Capability-Index/capcard

真相的来源目前存在于私人领域 capindex repo，并导出到此公共repo中。公共安全文件根据 oss/capcard/ 并向外同步。

范围边界

开源：

• 能力卡架构
• capcard 命令行界面
• 公共文档和示例

非开源：

• CapIndex托管指数
• 爬虫基础设施
• 排序逻辑
• 私有丰富工作流程

许可证

麻省理工学院