agent-card-starter

Kit inicial para pequenas empresas: cartão de agente A2A, cartão de servidor MCP, servidor de exemplo mínimo e validador. Apenas biblioteca padrão Python, MIT, documentação em inglês e alemão.

GitHub

Documentação

agent-card-starter

tests license MIT python 3.9+

Kit inicial para tornar uma pequena empresa legível e acessível para assistentes de IA: um cartão de agente A2A, um cartão de servidor MCP, um servidor MCP de exemplo mínimo e um validador. Apenas biblioteca padrão, Python 3.9+, licença MIT.

Starter-Set, damit ein kleiner Betrieb für KI-Assistenten lesbar und erreichbar wird: Agentenkarte (A2A), Server-Karte (MCP), ein minimaler MCP-Beispielserver und ein Prüfskript. Nur Python-Standardbibliothek, ab Python 3.9, MIT-Lizenz.

Mantido por flowboxx, uma agência que constrói portas de IA para empresas. Gepflegt von flowboxx, einer Agentur, die KI-Türen für Betriebe baut.

Inglês

O que está incluído

CaminhoO que é
examples/well-known/agent-card.jsonCartão de agente A2A para uma fictícia "Beispiel Dachdecker GmbH"
examples/well-known/agent.jsonCópia idêntica em bytes para leitores mais antigos
examples/agent-card.annotated.jsoncMesmo cartão com comentários (somente documentação)
examples/mcp-server-card.jsonCartão de servidor MCP para o mesmo negócio
templates/Modelos quase vazios: cartão de servidor e catálogo de IA
server/mcp_server.pyServidor MCP de exemplo via stdio: ferramentas leistungen e anfrage_anlegen (stub)
tools/validate_agent_card.pyValidador offline para cartão de agente, cartão de servidor e catálogo
tests/Suíte pytest

Início rápido

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

Use para o seu negócio

  1. Copie examples/well-known/agent-card.json, substitua nome, descrição, provedor e habilidades.
  2. Liste apenas serviços que você realmente oferece. Uma habilidade por serviço, IDs estáveis.
  3. Mantenha preços, números de telefone e promessas fora do cartão. Um humano responde a isso.
  4. Execute o validador, publique o arquivo em https://<your-domain>/.well-known/agent-card.json.
  5. Aponte supportedInterfaces para um endpoint que você realmente opera. O servidor de exemplo fala MCP via stdio para aprendizado. Um endpoint público precisa de transporte HTTP, limitação de taxa, proteção contra spam e aviso de privacidade. anfrage_anlegen é um stub de propósito.

Notas sobre os padrões

  • O cartão de agente segue os nomes de campos do A2A v1.0 (supportedInterfaces, skills, provider).
  • O cartão de servidor segue a proposta MCP Server Card (SEP-2127). É uma extensão e o esquema pode mudar. Verifique o esquema atual antes de publicar.
  • O validador verifica campos obrigatórios e algumas regras de sanidade. Não é uma validação completa de JSON Schema.
  • Nada aqui garante que um assistente mencionará ou recomendará você.

Alemão

O que está incluído

CaminhoConteúdo
examples/well-known/agent-card.jsonCartão de agente A2A para a fictícia "Beispiel Dachdecker GmbH"
examples/well-known/agent.jsonCópia idêntica em bytes para leitores mais antigos
examples/agent-card.annotated.jsoncMesmo cartão com comentários (somente para explicação)
examples/mcp-server-card.jsonCartão de servidor MCP para o mesmo negócio
templates/Modelos: cartão de servidor e catálogo de IA
server/mcp_server.pyServidor MCP de exemplo via stdio: ferramentas leistungen e anfrage_anlegen (stub)
tools/validate_agent_card.pyScript de verificação sem rede para cartão de agente, cartão de servidor e catálogo
tests/Testes pytest

Início rápido

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

Para usar no seu próprio negócio

  1. Copie examples/well-known/agent-card.json, substitua nome, descrição, provedor e habilidades.
  2. Liste apenas serviços que você realmente oferece. Uma habilidade por serviço, IDs estáveis.
  3. Sem preços, números de telefone ou promessas no cartão. Um humano responde a isso.
  4. Execute o script de verificação, coloque o arquivo em https://<Ihre-Domain>/.well-known/agent-card.json.
  5. Aponte supportedInterfaces para um endpoint que você realmente opera. O servidor de exemplo fala MCP via stdio para aprendizado. Um endpoint público precisa de HTTP, limitação de quantidade, proteção contra spam e aviso de privacidade. anfrage_anlegen é intencionalmente um stub e não armazena nada.

Notas sobre os padrões

  • O cartão de agente segue os nomes de campos do A2A v1.0 (supportedInterfaces, skills, provider).
  • O cartão de servidor segue a proposta MCP Server Card (SEP-2127). Isso é uma extensão, o esquema pode mudar. Verifique o esquema atual antes de publicar.
  • O script de verificação verifica campos obrigatórios e algumas plausibilidades, não uma validação completa de JSON Schema.
  • Nada aqui garante que um assistente mencionará ou recomendará você.

Como está / Sem garantia

Este é um ponto de partida, fornecido "como está" sob a licença MIT, sem garantia de qualquer tipo. Os padrões em torno de cartões de agente e cartões de servidor são novos e mudam. Verifique as especificações atuais antes de publicar. Nada aqui é aconselhamento jurídico, e nada garante que um assistente mencionará ou recomendará seu negócio. As alterações estão listadas em CHANGELOG.md, como ajudar está em CONTRIBUTING.md.

Dies ist ein Ausgangspunkt, bereitgestellt "wie besehen" unter der MIT-Lizenz, ohne Gewähr. Die Standards rund um Agentenkarten und Server-Karten sind jung und ändern sich. Prüfen Sie vor dem Veröffentlichen die aktuellen Spezifikationen. Nichts hier ist Rechtsberatung, und nichts garantiert, dass ein Assistent Ihren Betrieb nennt oder empfiehlt. Änderungen stehen in CHANGELOG.md, Mitmachen steht in CONTRIBUTING.md.

Licença MIT, veja LICENSE. Perguntas e contribuições são bem-vindas via issues. Fragen und Beiträge gern als Issue.

Construído e mantido por flowboxx, Alemanha.