Repolode
Enviar
ref-tools

ref-tools/ref-tools-mcp

Un servidor MCP que ofrece a los agentes de programación con IA acceso eficiente en tokens a la documentación de bibliotecas públicas y privadas.

Ver en GitHubSitio web
Estrellas
1,184
Forks
72
Issues abiertos
12
Último commit
ayer

¿Qué es?

Ref MCP es un servidor Model Context Protocol que permite a las herramientas y agentes de programación con IA buscar y leer documentación de API, servicios y bibliotecas. Ofrece una herramienta de búsqueda que acepta una consulta en una oración completa y devuelve resultados relevantes de páginas web públicas, GitHub y recursos privados, como repositorios y archivos PDF; además, incluye una herramienta de lectura que obtiene una URL y la convierte a markdown.

El proyecto se centra en mantener pequeña la ventana de contexto del agente. Durante una sesión MCP, registra las búsquedas anteriores para que las consultas repetidas no devuelvan los mismos resultados. Al leer una página extensa, también descarta las secciones menos relevantes según el historial de búsqueda y devuelve aproximadamente los 5.000 tokens más relevantes, en lugar de la página completa.

El servidor se puede conectar mediante un endpoint alojado de streamable-http, que es la opción recomendada por el proyecto, o ejecutarse localmente a través de stdio con npx. También ofrece nombres de herramientas compatibles con clientes de investigación profunda de OpenAI.

Funciones clave

  • 01Busca en la web pública, GitHub y fuentes de documentación privada con una sola herramienta de consulta.
  • 02Omite los resultados que ya se devolvieron antes en la misma sesión para evitar repeticiones.
  • 03Convierte una URL a markdown y la limita a las secciones más relevantes.
  • 04Ofrece opciones de conexión mediante streamable-http y stdio local.
  • 05Proporciona nombres de herramientas compatibles con la investigación profunda de OpenAI.

Casos de uso

  • Permitir que un agente de programación consulte endpoints de API actuales mientras escribe código de integración.
  • Dar a un agente acceso a la documentación interna privada de bibliotecas o a repositorios.
  • Reducir el costo en tokens y el ruido cuando los agentes leen páginas extensas de documentación.

Inicio rápido

  1. 1

    Regístrate en ref.tools para obtener una clave de API

  2. 2

    Añade el servidor stdio a la configuración de tu cliente MCP y ejecútalo con npx, definiendo REF_API_KEY

    npx ref-tools-mcp@latest

Antes de usarlo

  • Necesitas una clave de API de Ref, que puedes obtener al registrarte en ref.tools.
  • Este repositorio contiene el servidor stdio heredado; el README recomienda usar en su lugar el servidor streamable-http alojado.

En colecciones

Asistentes y agentes de programación con IAServidores MCPGeneradores de sitios estáticos y herramientas de documentación

Temas

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

Preguntas frecuentes

¿Qué es ref-tools-mcp?
Un servidor MCP que ofrece a los agentes de programación con IA acceso eficiente en tokens a la documentación de bibliotecas públicas y privadas. Ref MCP es un servidor Model Context Protocol que permite a las herramientas y agentes de programación con IA buscar y leer documentación de API, servicios y bibliotecas. Ofrece una herramienta de búsqueda que acepta una consulta en una oración completa y devuelve resultados relevantes de páginas web públicas, GitHub y recursos privados, como repositorios y archivos PDF; además, incluye una herramienta de lectura que obtiene una URL y la convierte a markdown.
¿ref-tools-mcp es gratuito? ¿Qué licencia tiene?
ref-tools-mcp es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ref-tools-mcp sigue mantenido?
Mantenimiento activo. El último commit de ref-tools-mcp fue el 6 nov 2026.
¿Para qué puedo usar ref-tools-mcp?
Permitir que un agente de programación consulte endpoints de API actuales mientras escribe código de integración. Dar a un agente acceso a la documentación interna privada de bibliotecas o a repositorios. Reducir el costo en tokens y el ruido cuando los agentes leen páginas extensas de documentación.
¿Cómo se instala ref-tools-mcp?
Regístrate en ref.tools para obtener una clave de API Añade el servidor stdio a la configuración de tu cliente MCP y ejecútalo con npx, definiendo REF_API_KEY: npx ref-tools-mcp@latest
¿Dónde consigo ref-tools-mcp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ref-tools/ref-tools-mcp

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados