Aller au contenu
Jefferson Gonçalves
§01 · MCP

Serveur MCP

Interrogez ce portfolio depuis un assistant IA plutôt que de le scraper — un serveur MCP public, en lecture seule, sur le catalogue de projets.

Configuration rapide

Choisissez votre assistant IA et collez la configuration ci-dessous.

claude mcp add --transport http portfolio https://jeffersongoncalves.dev.br/mcp
  1. Ouvrez Réglages → Connecteurs → Ajouter un connecteur personnalisé.
  2. Collez l'URL de l'endpoint ci-dessous et confirmez.
  3. Le serveur est public — aucun token ni identifiant nécessaire pour autoriser la connexion.
https://jeffersongoncalves.dev.br/mcp

.cursor/mcp.json

{
  "mcpServers": {
    "portfolio": {
      "url": "https://jeffersongoncalves.dev.br/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "portfolio": {
      "type": "http",
      "url": "https://jeffersongoncalves.dev.br/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.portfolio]
url = "https://jeffersongoncalves.dev.br/mcp"

~/.gemini/settings.json

{
  "mcpServers": {
    "portfolio": {
      "httpUrl": "https://jeffersongoncalves.dev.br/mcp"
    }
  }
}

Este site publica um servidor MCP (Model Context Protocol) público e somente leitura sobre o mesmo catálogo que você vê em /projects, /articles e /links — assim um assistente de IA (Claude, etc.) consegue buscar e ler essas páginas direto, sem precisar raspar HTML.

#Endpoint

https://jeffersongoncalves.dev.br/mcp

Transporte HTTP (Streamable HTTP), sem autenticação — o conteúdo já é público. Limitado a 60 requisições/min por IP. Mais abaixo tem configuração pronta pra copiar de acordo com seu assistente de IA.

#Testar localmente com o MCP Inspector

php artisan mcp:inspector mcp/portfolio

#O que ele expõe

  • search_projects — busca projetos, artigos e links curados por texto livre (query, também casa com o stack tecnológico e os topics, não só o nome), seção (section: projects/articles/links), categoria exata (category, ex: filament_plugin, laravel_package, starter_kit), idioma do resumo (locale: pt_BR/en/es, padrão en) e um limite de resultados (limit, 1-50). Devolve uma lista em Markdown com nome, URL canônica, categoria e um resumo de uma linha por página.
  • get_page — busca uma página publicada pelo slug (o mesmo que search_projects devolve) e opcionalmente locale (pt_BR/en/es) pro idioma do resumo: categoria, links de saída disponíveis (GitHub, Packagist, npm, Docker Hub, docs, demo), estrelas, downloads, licença, tipo de pacote, linguagem, versões de Filament suportadas, stack e topics, além de um trecho do README em texto puro (até 3000 caracteres, HTML já sanitizado e sem marcação).
  • get_site_stats — números agregados de todo o portfólio: total de repos e páginas do catálogo, downloads por registro (Packagist/npm/JetBrains/Docker), estrelas, seguidores e sponsors do GitHub, contagem de pacotes por categoria, as linguagens/topics mais frequentes e os links pra apoiar o trabalho (GitHub Sponsors, Buy Me a Coffee). Sem argumentos.
  • Resource site://llms.txt — o mesmo mapa de páginas em texto puro servido em /llms.txt: cada página pública do site com sua URL, pensado pra um assistente descobrir o catálogo inteiro numa leitura só.

#Detalhes técnicos

As três tools são somente leitura: search_projects e get_page consultam exatamente as mesmas linhas e o mesmo escopo published() que /projects, /articles e /links usam, e get_site_stats lê o mesmo agregado cacheado dos cards de estatística do site — nada escondido, nada mutável. O servidor roda sobre Laravel MCP com transporte Streamable HTTP; sem sessão nem handshake além do próprio protocolo MCP.

Nouvelle version disponible.