Integrations
Extracts code changes from Git commits and diffs to provide contextual information about your project's history
Gathers code from GitHub repositories to provide context about your project to LLMs
Supports specialized handling of PHP code, including the ability to extract PHP signatures without implementation details
ctx: El eslabón perdido entre tu código base y tu LLM. Herramienta de Contexto como Código (CaC) con servidor MCP integrado.
Tabla de contenido
CTX es una herramienta creada para resolver un gran problema al chatear con LLM como ChatGPT o Claude: darles suficiente contexto sobre tu proyecto .
Hay un artículo sobre Context Generator en Medium que explica la motivación detrás del proyecto y el problema que resuelve.
Al usar IA en el desarrollo, el contexto no solo es útil, sino fundamental. En lugar de copiar o explicar manualmente todo el código base cada vez, ctx crea automáticamente archivos de contexto limpios y organizados a partir de:
- Archivos de código,
- Repositorios de GitHub y Gitlab,
- Confirmaciones y diferencias de Git
- Páginas web (URL) con selectores CSS,
- Servidores MCP
- y texto plano.
Fue creado para resolver un problema común: proporcionar de manera eficiente a los modelos de lenguaje de IA como Claude el contexto necesario sobre su base de código.
Cómo funciona
- Recopila código de archivos, directorios, repositorios de GitHub o Gitlab, páginas web o texto sin formato.
- Busca archivos específicos a través de coincidencia de patrones, búsqueda de contenido, tamaño o filtros de fecha.
- Aplica modificadores opcionales (como extraer firmas PHP sin detalles de implementación)
- Organiza el contenido en documentos de rebajas bien estructurados
- Guarda archivos de contexto listos para ser compartidos con LLM
- Opcionalmente, sirve contexto a través de un servidor MCP, lo que permite que los asistentes de IA como Claude accedan directamente a la información del proyecto.
Inicio rápido
Comenzar a usar CTX es muy sencillo. Sigue estos sencillos pasos para crear tu primer archivo de contexto.
1. Instalar CTX
Descargue e instale la herramienta utilizando nuestro script de instalación:
Esto instala el comando ctx
en su sistema (normalmente en /usr/local/bin
).
¿Quieres más opciones? Consulta la Guía de instalación completa para ver métodos de instalación alternativos.
2. Inicializar un archivo de configuración
Cree un nuevo archivo de configuración en el directorio de su proyecto:
Esto genera un archivo context.yaml
con una estructura básica para ayudarle a comenzar.
Consulte la Referencia de comandos para conocer todos los comandos y opciones disponibles.
3. Describe la estructura de tu proyecto
Edite el archivo context.yaml
generado para especificar qué código o contenido desea incluir.
Por ejemplo:
Esta configuración reunirá todos los archivos PHP del directorio src/Auth
y cualquier archivo PHP que contenga "Usuario" en su nombre del directorio src/Models
.
¿Necesita una configuración más avanzada?
- Aprenda sobre la estructura y las propiedades del documento
- Explora diferentes tipos de fuentes como GitHub , Git Diff o URL
- Aplicar modificadores para transformar su contenido (como extraer firmas PHP)
- Descubra cómo utilizar variables de entorno en su configuración
- Utilice la integración IDE para autocompletar y validar
4. Construir el contexto
Genere su archivo de contexto ejecutando:
CTX procesará su configuración y creará el archivo de salida especificado ( auth-context.md
en nuestro ejemplo).
Consejo : Configure el registro con
-v
,-vv
o-vvv
para obtener una salida detallada
5. Compartir con un LLM
Sube o pega el archivo de contexto generado en tu LLM favorito (como ChatGPT o Claude). Ahora puedes hacer preguntas específicas sobre tu código base, y el LLM tendrá el contexto necesario para brindarte asistencia precisa.
Ejemplo de mensaje:
Compartí el código de mi sistema de autenticación con ustedes. ¿Podrían ayudarme a identificar posibles vulnerabilidades de seguridad en el proceso de registro de usuarios?
Próximos pasos: consulte Desarrollo con generador de contexto para conocer las mejores prácticas sobre cómo integrar la generación de contexto en su flujo de trabajo de desarrollo impulsado por IA.
¡Listo! Ya estás listo para aprovechar los LLM con el contexto adecuado de tu código fuente.
6. Conéctese a Claude AI (opcional)
Para una experiencia más fluida, puede conectar Context Generator directamente a Claude AI mediante el servidor MCP:
Hay un servidor MCP integrado que le permite conectar Claude AI directamente a su base de código.
Apunte el cliente MCP al servidor generador de contexto:
Nota: Lea más sobre el servidor MCP para obtener instrucciones de configuración detalladas.
¡Ahora puedes hacerle preguntas a Claude sobre tu base de código sin tener que cargar manualmente los archivos de contexto!
Documentación completa
Para obtener la documentación completa, incluidas todas las funciones y opciones de configuración disponibles, visite:
Licencia
Este proyecto está licenciado bajo la licencia MIT.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
CTX es una herramienta creada para resolver un gran problema al chatear con LLM como ChatGPT o Claude: brindarles suficiente contexto sobre tu proyecto.
Related MCP Servers
- AsecurityAlicenseAqualityEnables integration of Perplexity's AI API with LLMs, delivering advanced chat completion by utilizing specialized prompt templates for tasks like technical documentation, code review, and API documentation.Last updated -1948JavaScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.Last updated -TypeScript
- AsecurityFlicenseAqualityA model context protocol server that allows interaction with TriliumNext Notes, providing tools to create, search, retrieve, update, and delete notes through natural language commands.Last updated -51JavaScript
- -securityAlicense-qualityAn MCP server that provides integration with Microsoft's AutoGen framework, enabling multi-agent conversations through a standardized interface.Last updated -1PythonMIT License