Agent Card Starter

agent-card-starter

**60 秒了解：**AI 助手会读取一个小型 JSON 文件，了解您的业务内容。此工具会为您编写并检查该文件。离线运行，无需账户，也没有依赖项。

pip install agent-card-starter
agent-card init --name "Muster Roofing Ltd" --description "Roofer in Musterstadt, repairs and new roofs." --website https://www.example.com --skill "Flat roof sealing"
agent-card validate .well-known/agent-card.json --strict

将文件上传到 https://<your-domain>/.well-known/agent-card.json，即可让他人了解您的业务。这里的任何内容都不能保证助手会提及您。

**60 秒了解：**AI 助手会读取一个小型文件，了解您的业务内容。此工具会为您编写并检查该文件。离线运行，无需账户，也无需第三方软件包。命令见上方，文件应放到 https://<Ihre-Domain>/.well-known/agent-card.json。

此入门套件可帮助小型企业让 AI 助手能够了解并联系到自己： 包括 A2A Agent 卡片、MCP 服务卡片、一个最简 MCP 示例服务和一个验证器。 仅使用 Python 标准库，支持 Python 3.9 及以上版本，采用 MIT 许可证。

由 flowboxx 维护；这是一家为企业打造 AI 入口的代理机构。

---

English

包含内容

路径	内容
examples/well-known/agent-card.json	为虚构企业「Beispiel Dachdecker GmbH」编写的 A2A Agent 卡片
examples/well-known/agent.json	内容逐字节相同的副本，供较旧的读取器使用
examples/agent-card.annotated.jsonc	同一张卡片的注释版（仅供文档说明）
examples/mcp-server-card.json	为同一企业编写的 MCP 服务卡片
templates/	简易模板：服务卡片和 AI 目录
server/mcp_server.py	通过 stdio 运行的 MCP 示例服务：工具 leistungen 和 anfrage_anlegen（存根）
agent_card/	agent-card 命令：init 写入首张卡片，validate 检查卡片、服务卡片和目录（离线）
tools/validate_agent_card.py	与普通脚本功能相同的验证器
tests/	pytest 测试套件

快速开始

agent-card init --name "Your Business" --description "What you do and where." --website https://www.example.com
agent-card validate .well-known/agent-card.json --strict
# from a clone, without installing:
python3 tools/validate_agent_card.py examples/well-known/agent-card.json
python3 tools/validate_agent_card.py examples/mcp-server-card.json --strict
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list"}\n' | python3 server/mcp_server.py
python3 -m pip install pytest && python3 -m pytest -q
docker build -t agent-card-starter . && docker run -i --rm agent-card-starter   # MCP over stdio

用于您的业务

1. 复制 examples/well-known/agent-card.json，替换名称、描述、提供方和技能。
2. 只列出您实际提供的服务。每项服务对应一个技能，并使用稳定的 ID。
3. 不要在卡片中写入价格、电话号码和承诺。这些问题由人工回答。
4. 运行验证器，并将文件发布到 https://<your-domain>/.well-known/agent-card.json。
5. 将 supportedInterfaces 指向您实际运营的端点。示例服务通过 stdio 提供 MCP，供学习使用。公共端点需要 HTTP 传输、 速率限制、垃圾信息防护和隐私声明。anfrage_anlegen 是有意设置的存根。

标准说明

• Agent 卡片采用 A2A v1.0 字段名称（supportedInterfaces、skills、provider）。
• 服务卡片遵循 MCP Server Card 提案（SEP-2127）。这是一个扩展， 其架构仍可能发生变化。发布前请检查当前架构。
• 验证器会检查必填字段和一些合理性规则，但并非完整的 JSON Schema 验证。
• 这里的任何内容都不能保证助手会提及或推荐您。

---

Deutsch

包含内容

路径	内容
examples/well-known/agent-card.json	为虚构的“Beispiel Dachdecker GmbH”制作的 A2A Agent 卡片
examples/well-known/agent.json	字节完全相同的副本，供旧版读取器使用
examples/agent-card.annotated.jsonc	带注释的同一张卡片（仅供说明）
examples/mcp-server-card.json	同一家企业的 MCP 服务卡片
templates/	模板：服务卡片和 AI 目录
server/mcp_server.py	通过 stdio 运行的 MCP 示例服务：工具 leistungen 和 anfrage_anlegen（存根）
agent_card/	命令 agent-card：init 写入初始卡片，validate 检查卡片、服务卡片和目录（不联网）
tools/validate_agent_card.py	同一检查脚本的独立文件版本
tests/	pytest 测试

快速开始

agent-card init --name "Ihr Betrieb" --description "Was Sie tun und wo." --website https://www.example.com
agent-card validate .well-known/agent-card.json --strict
# aus einem Klon, ohne Installation:
python3 tools/validate_agent_card.py examples/well-known/agent-card.json
python3 tools/validate_agent_card.py examples/mcp-server-card.json --strict
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list"}\n' | python3 server/mcp_server.py
python3 -m pip install pytest && python3 -m pytest -q
docker build -t agent-card-starter . && docker run -i --rm agent-card-starter   # MCP over stdio

用于自己的企业

1. 复制 examples/well-known/agent-card.json，替换名称、描述、提供方和能力。
2. 只填写您确实提供的服务。每项服务对应一项能力，并使用稳定的 Id。
3. 不要在卡片中填写价格、电话号码或承诺。这些由人来回答。
4. 运行检查脚本，将文件放在 https://<Ihre-Domain>/.well-known/agent-card.json。
5. 让 supportedInterfaces 指向您实际运营的端点。示例服务通过 stdio 使用 MCP，供学习之用。公开端点需要 HTTP、速率限制、 垃圾信息防护和隐私声明。anfrage_anlegen 有意设为存根，不会保存任何内容。

标准说明

• Agent 卡片采用 A2A v1.0 的字段名（supportedInterfaces、skills、provider）。
• 服务卡片遵循 MCP 提案 Server Card（SEP-2127）。这是一项扩展，架构仍可能发生变化。发布前请检查最新架构。
• 检查脚本会检查必填字段和一些合理性，但不会进行完整的 JSON Schema 验证。
• 这里的任何内容都不能保证助手会提及或推荐您。

---

用这个制作了什么？告诉我们

如果您使用这个工具包发布了卡片，请在 Discussions, Show and tell 中展示。我们会阅读每一篇帖子。如有需要，可将徽章添加到您的 README：

使用这个工具包发布了卡片？请在 Discussions, Show and tell 中展示。将徽章添加到您的 README：

[![built with agent-card-starter](https://img.shields.io/badge/built%20with-agent--card--starter-2b6cb0)](https://github.com/flowboxx/agent-card-starter)

---

按现状提供／不作保证

这是一个起点，依据 MIT 许可证按“现状”提供，不附带任何形式的保证。Agent 卡片和服务卡片相关标准尚处于早期阶段，且仍在变化。发布前请检查当前规范。这里的任何内容都不构成法律建议，也不保证助手会提及或推荐您的企业。变更记录见 CHANGELOG.md，参与方式见 CONTRIBUTING.md。

这是一个起点，依据 MIT 许可证按“现状”提供，不附带任何形式的保证。Agent 卡片和服务卡片相关标准尚处于早期阶段，且仍在变化。发布前请检查当前规范。这里的任何内容都不构成法律建议，也不保证助手会提及或推荐您的企业。变更记录见 CHANGELOG.md，参与方式见 CONTRIBUTING.md。

MIT 许可证，详见 LICENSE。欢迎通过 issue 提问和贡献。

由德国的 flowboxx 构建并维护。