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 にアップロードすれば、情報を読み取れるようになります。ただし、アシスタントがあなたのことに言及する保証はありません。

小規模事業者の情報を AI アシスタントが読み取り、連絡できるようにするためのスターターキットです。 A2A エージェントカード、MCP サーバーカード、最小限の MCP サンプルサーバー、バリデーターが含まれます。 Python 3.9 以上の標準ライブラリのみを使用し、MIT ライセンスで提供されています。

flowboxx が保守しています。flowboxx は、事業者向けに AI の窓口を構築するエージェンシーです。

---

English

内容

パス	内容
examples/well-known/agent-card.json	架空の「Beispiel Dachdecker GmbH」の A2A エージェントカード
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. 実際に提供しているサービスだけを記載します。サービスごとにスキルを1つ設定し、IDは固定します。
3. 価格、電話番号、約束事はカードに記載しないでください。これらには人が対応します。
4. バリデーターを実行し、ファイルを https://<your-domain>/.well-known/agent-card.json で公開します。
5. supportedInterfaces には、実際に運用しているエンドポイントを指定します。サンプルサーバーは学習用に stdio 経由で MCP を扱います。 公開エンドポイントには HTTP トランスポート、レート制限、スパム対策、プライバシーに関する通知が必要です。anfrage_anlegen は意図的にスタブになっています。

標準規格に関する注記

• エージェントカードは A2A v1.0 のフィールド名（supportedInterfaces、skills、provider）に準拠しています。
• サーバーカードは MCP Server Card 提案（SEP-2127）に準拠しています。これは拡張仕様であり、スキーマは今後変更される可能性があります。公開前に最新のスキーマを確認してください。
• バリデーターは必須フィールドといくつかの妥当性ルールを確認します。完全な JSON Schema 検証ではありません。
• アシスタントがあなたのことに言及したり、推薦したりする保証はありません。

---

Deutsch

含まれるもの

パス	内容
examples/well-known/agent-card.json	架空の「Beispiel Dachdecker GmbH」向けA2Aエージェントカード
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. 実際に提供しているサービスだけを記載します。サービスごとに機能を1つ記載し、IDは安定したものにします。
3. カードに価格、電話番号、約束を記載しないでください。それらは人間が回答します。
4. 検証スクリプトを実行し、ファイルをhttps://<Ihre-Domain>/.well-known/agent-card.jsonに配置します。
5. supportedInterfacesは、実際に運用しているエンドポイントを指すようにします。サンプルサーバーは学習用にstdio経由でMCPを提供します。公開エンドポイントにはHTTP、レート制限、スパム対策、プライバシー通知が必要です。anfrage_anlegenは意図的にスタブとなっており、何も保存しません。

標準に関する注意事項

• エージェントカードはA2A v1.0のフィールド名（supportedInterfaces、skills、provider）に準拠しています。
• サーバーカードはMCPの提案であるServer Card（SEP-2127）に準拠しています。これは拡張仕様であり、スキーマはまだ変更される可能性があります。公開前に最新のスキーマを確認してください。
• 検証スクリプトは必須フィールドといくつかの妥当性を確認しますが、完全なJSON Schema検証は行いません。
• ここに記載されている内容は、アシスタントがあなたを紹介したり推奨したりすることを保証するものではありません。

---

これを使って作成しましたか？ぜひ教えてください

このキットでカードを公開した場合は、ディスカッションの「Show and tell」で紹介してください。すべて目を通しています。よろしければ、READMEにバッジを追加してください。

このキットでカードを公開した場合は、ディスカッションの「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ライセンスのもと、いかなる種類の保証もなく「現状のまま」提供されます。エージェントカードやサーバーカードに関する標準はまだ新しく、変更される可能性があります。公開前に最新の仕様を確認してください。ここに記載されている内容は法的助言ではなく、アシスタントがあなたの事業を紹介したり推奨したりすることを保証するものでもありません。変更内容はCHANGELOG.mdに、協力方法はCONTRIBUTING.mdに記載されています。

MITライセンスについてはLICENSEを参照してください。質問や貢献はIssueから歓迎します。質問や貢献はIssueでお気軽にお寄せください。

flowboxx（ドイツ）が作成・保守しています。