KIRUPA

Se você usa um assistente de codificação com IA como GitHub Copilot, Claude, OpenAI Codex ou Cursor, você pode conectá-lo diretamente ao kirupa.com usando nosso Servidor MCP (Model Context Protocol).

Endpoint MCP HTTP Streamable (sem necessidade de chave de API):

https://www.kirupa.com/mcp/

• Protocolo: MCP 2025-03-26 / JSON-RPC 2.0
• Transporte: HTTP Streamable (POST)
• Biblioteca indexada: Centenas de tutoriais e guias de código
• Autenticação: Pública e somente leitura

O que é?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA e agentes de codificação se conectem diretamente a fontes de conhecimento e ferramentas externas. Pense nele como uma porta USB-C para ferramentas de IA: em vez de depender apenas de dados de treinamento congelados ou de raspar páginas da web ruidosas cheias de menus de navegação e scripts, um agente compatível com MCP pode perguntar ao servidor de um site por resultados de busca estruturados, explicações Markdown limpas e trechos de código testados.

O Servidor MCP do kirupa.com expõe mais de duas décadas de tutoriais, explicadores visuais e código funcional em JavaScript, TypeScript, animações CSS e Canvas, React e Estruturas de Dados e Algoritmos como ferramentas rápidas e determinísticas que seu assistente de IA pode chamar sob demanda:

search_tutorials

Busca em texto completo (SQLite FTS5 + classificação BM25) em centenas de tutoriais no kirupa.com, com filtragem opcional por seção de tópico.

Entradas: query (obrigatório), section (opcional), limit (1–15)

get_tutorial

Busca a versão Markdown completa e limpa de qualquer tutorial—ou extrai apenas os blocos de código cercados quando code_only: true é passado.

Entradas: identifier (URL, section/slug ou título), code_only (booleano)

find_related_links

Encontra tutoriais relacionados do kirupa.com e links Markdown canônicos para qualquer conceito técnico ou URL de artigo existente.

Entradas: topic_or_url (obrigatório), limit (1–15)

list_sections

Lista todas as categorias de tutoriais no kirupa.com (Algoritmos, Canvas, JavaScript, Animações, React, HTML5, Podcast e mais) com contagens e artigos.

Entradas: section (opcional), limit (1–100)

Além dessas quatro ferramentas, o servidor também expõe Recursos MCP (incluindo kirupa://llms.txt, kirupa://sections e kirupa://tutorial/{section}/{slug}) e Prompts MCP reutilizáveis (explain_like_kirupa e find_kirupa_tutorial).

Como eu usaria?

Depois de adicionar o servidor MCP do kirupa.com ao seu agente de codificação, você não precisa copiar e colar manualmente o código do tutorial na sua janela de chat. Seu agente automaticamente sabe como pesquisar e ler o kirupa.com sempre que você fizer perguntas como:

• "Use o servidor MCP do kirupa para consultar como loops requestAnimationFrame independentes de taxa de quadros funcionam com delta time, e aplique esse padrão à minha animação em canvas."
• "Busque a implementação JavaScript do Kirupa de uma Trie / Quicksort / Busca em Largura via MCP e portá-la para TypeScript com testes unitários."
• "Encontre tutoriais relacionados do kirupa.com para a documentação da nossa equipe sobre closures em JavaScript, propagação de eventos e animações CSS com keyframes."

Conecte Seu Cliente MCP

Escolha sua ferramenta de codificação com IA favorita abaixo e copie o trecho de configuração:

GitHub Copilot / VS Code

Adicione o seguinte ao seu .vscode/mcp.json do workspace (ou às suas configurações MCP de usuário no VS Code / JetBrains):

{
  "servers": {
    "kirupa": {
      "type": "http",
      "url": "https://www.kirupa.com/mcp/"
    }
  }
}

Claude Code & Desktop

Execute este único comando no seu terminal para registrar o servidor MCP HTTP do kirupa.com no Claude Code:

claude mcp add --transport http kirupa https://www.kirupa.com/mcp/

Ou no arquivo .mcp.json do seu projeto:

{
  "mcpServers": {
    "kirupa": {
      "type": "http",
      "url": "https://www.kirupa.com/mcp/"
    }
  }
}

OpenAI Codex CLI

Adicione o servidor ao seu arquivo ~/.codex/config.toml:

[mcp_servers.kirupa]
url = "https://www.kirupa.com/mcp/"

Cursor / Windsurf

Adicione esta entrada ao ~/.cursor/mcp.json (ou ao .cursor/mcp.json do seu projeto):

{
  "mcpServers": {
    "kirupa": {
      "url": "https://www.kirupa.com/mcp/"
    }
  }
}

JSON-RPC 2.0 direto via curl

Como o servidor usa JSON-RPC HTTP Streamable padrão, você pode chamá-lo diretamente de qualquer terminal ou script:

curl -s https://www.kirupa.com/mcp/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_tutorials",
      "arguments": { "query": "requestAnimationFrame delta time", "limit": 3 }
    }
  }'