Repolode
Enviar
ref-tools

ref-tools/ref-tools-mcp

Um servidor MCP que oferece a agentes de programação com IA acesso eficiente em tokens à documentação de bibliotecas públicas e privadas.

Ver no GitHubSite
Estrelas
1,184
Forks
72
Issues abertas
12
Último commit
há 14 dias

O que é?

O Ref MCP é um servidor Model Context Protocol que permite que ferramentas e agentes de programação com IA pesquisem e leiam documentação de APIs, serviços e bibliotecas. Ele oferece uma ferramenta de busca que aceita consultas em frases completas e retorna resultados relevantes de páginas públicas da web, do GitHub e de fontes privadas, como repositórios e PDFs, além de uma ferramenta de leitura que acessa uma URL e a converte para Markdown.

O projeto busca manter pequeno o contexto do agente. Durante uma sessão MCP, ele registra as buscas anteriores para que consultas repetidas não retornem os mesmos resultados. Ao ler uma página longa, também descarta as seções menos relevantes com base no histórico de buscas, retornando cerca de 5 mil tokens com o conteúdo mais pertinente, em vez da página inteira.

O servidor pode ser conectado por um endpoint hospedado streamable-http, recomendado pelo projeto, ou executado localmente via stdio com npx. Ele também oferece nomes de ferramentas compatíveis com clientes de deep research da OpenAI.

Recursos principais

  • 01Pesquisa na web pública, no GitHub e em fontes privadas de documentação usando uma única ferramenta de busca.
  • 02Ignora resultados já retornados na mesma sessão para evitar repetições.
  • 03Converte uma URL para Markdown e mantém apenas as seções mais relevantes.
  • 04Oferece opções de conexão via streamable-http e stdio local.
  • 05Oferece nomes de ferramentas compatíveis com deep research da OpenAI.

Casos de uso

  • Permitir que um agente de programação consulte endpoints atuais de APIs enquanto escreve código de integração.
  • Dar a um agente acesso à documentação interna privada de bibliotecas ou a repositórios.
  • Reduzir o custo em tokens e o ruído quando agentes leem páginas longas de documentação.

Início rápido

  1. 1

    Cadastre-se em ref.tools para obter uma chave de API

  2. 2

    Adicione o servidor stdio à configuração do seu cliente MCP e execute-o com npx, definindo REF_API_KEY

    npx ref-tools-mcp@latest

Antes de usar

  • É necessária uma chave de API da Ref, obtida ao se cadastrar em ref.tools.
  • Este repositório contém o servidor stdio legado; o README recomenda usar o servidor streamable-http hospedado.

Em coleções

Assistentes e agentes de programação com IAServidores MCPGeradores de sites estáticos e ferramentas de documentação

Tópicos

#mcp#coding-agent#documentation#llm#context-window#developer-tools#documentation-tool#mcp-server

Perguntas frequentes

O que é ref-tools-mcp?
Um servidor MCP que oferece a agentes de programação com IA acesso eficiente em tokens à documentação de bibliotecas públicas e privadas. O Ref MCP é um servidor Model Context Protocol que permite que ferramentas e agentes de programação com IA pesquisem e leiam documentação de APIs, serviços e bibliotecas. Ele oferece uma ferramenta de busca que aceita consultas em frases completas e retorna resultados relevantes de páginas públicas da web, do GitHub e de fontes privadas, como repositórios e PDFs, além de uma ferramenta de leitura que acessa uma URL e a converte para Markdown.
ref-tools-mcp é gratuito? Qual é a licença?
ref-tools-mcp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ref-tools-mcp ainda é mantido?
Manutenção ativa. O último commit de ref-tools-mcp foi em 24 de out. de 2026.
Para que posso usar ref-tools-mcp?
Permitir que um agente de programação consulte endpoints atuais de APIs enquanto escreve código de integração. Dar a um agente acesso à documentação interna privada de bibliotecas ou a repositórios. Reduzir o custo em tokens e o ruído quando agentes leem páginas longas de documentação.
Como instalar ref-tools-mcp?
Cadastre-se em ref.tools para obter uma chave de API Adicione o servidor stdio à configuração do seu cliente MCP e execute-o com npx, definindo REF_API_KEY: npx ref-tools-mcp@latest
Onde consigo ref-tools-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ref-tools/ref-tools-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados