¿Qué hace star-knowledge-base?
Convierte tus estrellas de GitHub de marcadores a un caja de herramientas de código personal que los agentes pueden buscar | MCP + Agent Skill + GitHub Pages
¿Qué es esto?
star-knowledge-base es una herramienta impulsada por IA que transforma todas tus estrellas de GitHub en una base de conocimiento semántica. Al usar el Protocolo de Contexto del Modelo (MCP) y Agent Skill, permite que agentes de IA como Claude Code, Cursor y Codex accedan directamente a tus repositorios favoritos y los utilicen como una caja de herramientas de código personal.
Características
- Búsqueda semántica – Los agentes pueden buscar proyectos por significado, no solo por palabras clave
- Cero configuración – Funciona con tus estrellas de GitHub existentes; no se requiere indexación manual
- Implementación en GitHub Pages – Sin necesidad de servidores backend; despliega tu base de conocimiento de forma gratuita
- Integración con MCP – Conecta agentes de IA de forma nativa usando el Protocolo de Contexto del Modelo
Cómo funciona
- Otorga acceso de solo lectura a tus estrellas de GitHub
- El sistema extrae la metadata (descripciones, temas, archivos README) de cada repositorio
- Crea un índice de búsqueda semántica utilizando modelos de incrustación
- Publica el índice en GitHub Pages
- Los agentes de IA consultan el índice a través de MCP para recuperar repositorios relevantes e información de código
Instalación
# Clona el repositorio
git clone https://github.com/tu-usuario/star-knowledge-base.git
# Instala dependencias
pnpm install
# Configura las variables de entorno
cp .env.example .env
# Agrega tu token de acceso personal de GitHub y la clave de API de OpenAI
Uso con agentes de IA
Claude Code
Agrega la siguiente configuración a tu proyecto:
{
"mcpServers": [
{
"name": "star-knowledge-base",
"url": "https://tu-usuario.github.io/star-knowledge-base/mcp.json"
}
]
}
Cursor
Configura Agent Skill apuntando a la rutadel archivo de tu base de conocimiento local.
Codex
Haz referencia al punto final desplegado como una fuente de contexto externa.
Variables de entorno
| Variable | Descripción |
|---|---|
GITHUB_TOKEN | Token de acceso personal de GitHub (alcance: solo lectura de repositorio) |
OPENAI_API_KEY | Clave de API de OpenAI para incrustaciones |
BASE_URL | URL base de implementación (por ejemplo, https://tu-usuario.github.io/star-knowledge-base) |
Despliegue
pnpm run deploy
Esto construirá el artefacto estático y lo empujará a la rama gh-pages. Una vez que GitHub Pages esté habilitado, la base de conocimiento estará disponible en https://tu-usuario.github.io/star-knowledge-base.
Contribuye
¡Las contribuciones son bienvenidas! Por favor, abre un issue o envía un pull request.
Licencia
Licencia MIT