Librarian

Memoria persistente con búsqueda semántica, clasificación por aciertos, importación universal y un mercado de conocimiento.

GitHub

Prueba este MCPPatrocinado

Documentación

Librarian

Un servidor MCP de gestión del conocimiento para asistentes de codificación con IA. Captura conocimientos, busca con comprensión semántica y accede a una biblioteca de conocimiento para desarrolladores.

Instalación

Claude Code (Recomendado)

Plugin (experiencia completa)

Incluye herramientas MCP, comandos de barra y hooks.

/plugin marketplace add telvokdev/librarian
/plugin install librarian@librarian

Solo MCP

claude mcp add librarian -- npx @telvok/librarian-mcp

Cursor

Añade a .cursor/mcp.json:

{
  "mcpServers": {
    "librarian": {
      "command": "npx",
      "args": ["@telvok/librarian-mcp"]
    }
  }
}

Windsurf

Añade a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "librarian": {
      "command": "npx",
      "args": ["@telvok/librarian-mcp"]
    }
  }
}

Cualquier cliente MCP

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "librarian": {
      "command": "npx",
      "args": ["@telvok/librarian-mcp"]
    }
  }
}

O instala globalmente:

npm install -g @telvok/librarian-mcp

Inicio Rápido

// Search before making decisions
brief({ query: "stripe webhook handling" })

// Capture what you learned
record({
  insight: "Stripe retries webhooks but doesn't dedupe - always check idempotency key",
  context: "payments, webhooks"
})

// Mark helpful entries to boost their ranking
mark_hit({ path: "local/stripe-webhooks-need-idempotency.md" })

// Browse the library
library_search({ query: "react patterns" })

Referencia de API (Beta)

Conocimiento local

Herramienta	Propósito
`brief(query?, limit?)`	Búsqueda semántica en tu biblioteca
`record(insight, ...)`	Captura conocimiento que vale la pena conservar
`adopt(path, title?)`	Copia la entrada importada a la biblioteca local
`mark_hit(path)`	Marca una entrada como útil (aumenta el ranking)
`import_memories(format, path)`	Importa desde otras herramientas de IA
`rebuild_index(force?)`	Reconstruye los embeddings de búsqueda semántica
`delete(path?, query?, confirm?)`	Elimina entradas de la biblioteca local

Biblioteca

Explora y publica libros en telvok.com. Se admiten contenido gratuito y de pago.

Herramienta	Propósito
`library_search(query, filters?)`	Busca en la biblioteca de Telvok
`library_download(slug)`	Descarga un libro gratuito localmente
`library_publish(name, attestation, ...)`	Publica entradas como un libro
`my_books(filter?)`	Ver libros publicados y descargados
`sync(slug?, force?)`	Comprueba actualizaciones de libros que posees
`rate_book(slug, rating, ...)`	Califica un libro (1-5 estrellas)
`seller_analytics()`	Ver estadísticas de descarga de tus libros

Recompensas

Herramienta	Propósito
`bounty_create(title, ...)`	Publica una solicitud de conocimiento
`bounty_list(query?, tags?, status?)`	Explora las recompensas disponibles
`bounty_claim(bounty_id)`	Reclama una recompensa para cumplirla
`bounty_submit(bounty_id, book_slug)`	Envía el cumplimiento
`my_bounties(role?)`	Ver tus recompensas

Cuenta

Herramienta	Propósito
`auth(action)`	Iniciar sesión, cerrar sesión, estado, completar
`help(topic?)`	Obtén ayuda sobre cualquier herramienta
`feedback(message, type?)`	Envía comentarios

Cómo funciona la búsqueda

Librarian utiliza embeddings de IA locales para la búsqueda semántica:

You saved:   "Stripe webhooks need idempotency checks"
You search:  "handling duplicate payment events"
→ It finds it.

all-MiniLM-L6-v2 modelo (embeddings de 384 dimensiones)
Descarga de ~30MB en la primera ejecución, almacenado en caché localmente
Sin llamadas a API — completamente sin conexión

Formatos de importación

Formato	Fuentes
`jsonl`	Anthropic MCP Memory, mcp-knowledge-graph
`markdown`	Obsidian, Basic Memory MCP
`cursor`	Cursor Memory Bank
`json`	Servidores de memoria simples
`sqlite`	mcp-memory-service, SQLite-vec

Autenticación

auth({ action: "login" }) — devuelve código + URL
Visita telvok.com/device, introduce el código
auth({ action: "complete" }) — guarda la clave API localmente

Las claves se almacenan en .librarian/.auth, expiran después de 90 días.

Estructura de la biblioteca

.librarian/
├── local/        # Your entries
├── imported/     # Downloaded books
├── packages/     # Purchased content
├── archived/     # Stale but searchable
├── index.json    # Semantic embeddings
├── models/       # Cached embedding model
└── .auth         # API key (git-ignored)

Contribuir

Haz un fork del repositorio
Crea una rama de características (git checkout -b feature/my-feature)
Haz commit de los cambios (git commit -m 'Add my feature')
Haz push (git push origin feature/my-feature)
Abre un Pull Request

Licencia

MIT - Telvok