Ilograph MCP Server

🎯 Ilograph MCP Server

O Ilograph MCP Server é um servidor Model Context Protocol (MCP) que fornece aos agentes de IA acesso abrangente à documentação do Ilograph, ferramentas de validação e orientação para criação de diagramas. Transforme documentação de arquitetura complexa com assistência inteligente.

Casos de Uso

• Criação Automatizada de Diagramas: Gere diagramas Ilograph por meio de descrições em linguagem natural
• Validação em Tempo Real: Valide diagramas existentes com análise detalhada de erros e sugestões
• Acesso à Documentação: Obtenha acesso instantâneo à documentação abrangente do Ilograph e às melhores práticas
• Aprendizado e Exemplos: Explore exemplos de diagramas selecionados com explicações detalhadas

Importante: Este é um projeto não oficial, conduzido pela comunidade e não é afiliado ou endossado pela Ilograph LLC. O servidor fornece assistência educacional e de desenvolvimento ao acessar documentação e recursos públicos do Ilograph.

Atenção: As saídas e recomendações fornecidas pelo servidor MCP são geradas dinamicamente e podem variar com base na consulta e no modelo. Os usuários devem revisar minuciosamente todas as saídas para garantir que estejam alinhadas com os requisitos do projeto e verificar na documentação oficial do Ilograph antes da implementação.

Pré-requisitos

1. Docker: Docker instalado e em execução
2. Cliente compatível com MCP: Claude Desktop, VS Code, Cursor, etc.

Início Rápido

Adicionar ao Seu Cliente MCP

Adicione esta configuração ao seu cliente MCP:

VS Code:

Adicione o seguinte bloco JSON ao arquivo User Settings (JSON) no VS Code. Você pode fazer isso pressionando Ctrl + Shift + P e digitando Preferences: Open User Settings (JSON).

Mais informações sobre como usar as ferramentas do servidor MCP na documentação do modo agente do VS Code.

{
  "mcp": {
    "servers": {
      "ilograph": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
        ]
      }
    }
  }
}

Opcionalmente, você pode adicionar um exemplo semelhante (ou seja, sem a chave mcp) a um arquivo chamado .vscode/mcp.json no seu workspace. Isso permitirá que você compartilhe a configuração com outras pessoas.

{
  "servers": {
    "ilograph": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
      ]
    }
  }
}

Claude Desktop / Cursor / Jetbrains AI Assistant:

{
  "mcpServers": {
    "ilograph": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"]
    }
  }
}

É isso! 🎉

Configuração de Ferramentas

Ferramentas Disponíveis

As seguintes ferramentas estão disponíveis para suporte abrangente ao fluxo de trabalho do Ilograph:

Categoria	Ferramenta	Descrição
Documentação	fetch_documentation_tool	Busca documentação abrangente das fontes oficiais do Ilograph com cache inteligente
Documentação	list_documentation_sections	Lista todas as seções de documentação disponíveis com descrições e áreas de cobertura
Documentação	check_documentation_health	Realiza verificações de integridade e retorna estatísticas de cache para o serviço de documentação
Especificação	fetch_spec_tool	Busca a especificação oficial do Ilograph com definições completas de propriedades e tipos
Especificação	check_spec_health	Realiza verificações de integridade especificamente na conectividade do serviço de especificação
Exemplos	list_examples	Lista exemplos de diagramas Ilograph disponíveis categorizados por complexidade e caso de uso
Exemplos	fetch_example	Recupera exemplos específicos de diagramas com metadados, contexto de aprendizado e explicações
Validação	validate_diagram_tool	Valida a sintaxe de diagramas Ilograph e fornece mensagens de erro detalhadas com sugestões
Validação	get_validation_help	Fornece orientação abrangente sobre validação de diagramas e resolução de problemas comuns
Ícones	search_icons_tool	Pesquisa o catálogo de ícones ao vivo do Ilograph com correspondência semântica e filtragem por provedor
Ícones	list_icon_providers_tool	Lista todos os provedores de ícones disponíveis (AWS, Azure, GCP, etc.) e suas categorias de serviços

Contribuindo

Contribuições são bem-vindas! Este projeto precisa de:

• 🐛 Correções de bugs - Sempre apreciadas!
• 📚 Melhorias na documentação - Ajude a tornar as coisas mais claras
• ✨ Novas ferramentas - Adicione mais funcionalidades ao Ilograph
• 🔧 Qualidade de código - Melhor tratamento de erros, etc.

📖 Consulte CONTRIBUTING.md para configuração detalhada de desenvolvimento, testes e diretrizes de envio.

Recursos

• 📚 Acesso à Documentação ao Vivo: Busca documentação atualizada das fontes oficiais do Ilograph
• 🔍 Cobertura Abrangente de Seções: Acesso a todos os principais conceitos do Ilograph (recursos, perspectivas, contextos, etc.)
• ✅ Validação Avançada de Diagramas: Validação de esquema YAML e Ilograph com mensagens de erro detalhadas e sugestões
• ⚡ Cache Inteligente: Cache baseado em TTL com estratégias de fallback para desempenho ideal
• 🛠️ Design Focado em Ferramentas: Compatível com todos os clientes MCP atuais (Cursor, Claude Desktop, VS Code, etc.)
• 📋 Biblioteca de Exemplos Selecionados: Diagramas Ilograph do mundo real com contexto de aprendizado e explicações
• 🎨 Pesquisa Inteligente de Ícones: Pesquisa semântica no catálogo de ícones do Ilograph com filtragem por provedor
• 🔄 Monitoramento de Integridade: Verificações de integridade do serviço e relatórios de status integrados
• 🏗️ Detecção de Padrões de Arquitetura: Identifica padrões comuns e fornece sugestões de otimização

Precisa de Ajuda?

• Uso de Ferramentas: Consulte as ferramentas disponíveis na tabela acima
• Problemas: GitHub Issues
• Perguntas: GitHub Discussions

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Aviso Legal

Este projeto não é afiliado, endossado ou conectado à Ilograph LLC. Esta é uma ferramenta independente, conduzida pela comunidade, que acessa documentação e recursos públicos do Ilograph para fins educacionais e de desenvolvimento.

• O nome Ilograph e as marcas registradas relacionadas são propriedade da Ilograph LLC
• Esta ferramenta acessa documentação publicamente disponível sob princípios de uso justo
• Os usuários devem consultar a documentação oficial do Ilograph para obter informações autorizadas
• Não existe relação comercial entre este projeto e a Ilograph LLC

Links

• Site Oficial do Ilograph
• Documentação do Ilograph
• Model Context Protocol
• Framework FastMCP

---

Feito com ❤️ para a comunidade Ilograph