Library MCP

Un servidor local para consultar e interactuar con bases de conocimiento Markdown por etiquetas, texto, slug o fecha.

Documentación

library-mcp es un servidor MCP para interactuar con bases de conocimiento en Markdown. Básicamente, carpetas que pueden o no tener subcarpetas, que incluyen archivos con extensión .md y que comienzan con metadatos como:

----
title: My blog post
tags:
- python
- programming
url: /my-blog-post
---

# My blog post
Yesterday I was dreaming about...

El flujo de trabajo típico en la versión actual es recuperar contenido reciente para una etiqueta determinada y luego discutir usando esa etiqueta:

Get the next 50 posts with tag "executive",
then tell me what I should do about this problem
I am running into: ...

También puedes hacer lo mismo pero por rangos de fechas:

Summarize the blog posts I wrote in the past year.

Podrías preguntarte razonablemente "¿por qué no simplemente subir todo tu blog al contexto?" y hay dos lugares donde esta biblioteca supera ese enfoque:

Mi corpus de blog es mucho más grande que las ventanas de contexto de la mayoría de los modelos hoy en día. Además, incluso si las ventanas de contexto se volvieran exhaustivamente grandes, escribí muchas cosas mediocres en el pasado, así que quizás omitirlas es una característica.
Tengo varias bases de conocimiento Markdown distintas, y esto me permite operar a través de ellas en conjunto.

Finalmente, este es un proyecto de hobby, destinado a ejecutarse localmente en tu portátil. Ningún humano ha sido dañado usando este software, ¡pero funciona bastante bien!

Herramientas

Este servidor MCP expone estas herramientas.

Herramientas de Búsqueda de Contenido

Herramientas para recuperar contenido en tu ventana de contexto:

get_by_tag - Recupera contenido por etiqueta
get_by_text - Busca contenido por texto específico
get_by_slug_or_url - Encuentra publicaciones por slug o URL
get_by_date_range - Obtiene publicaciones publicadas dentro de un rango de fechas

Herramientas de Gestión de Etiquetas

Herramientas para navegar tu base de conocimiento:

search_tags - Busca etiquetas que coincidan con una consulta
list_all_tags - Lista todas las etiquetas ordenadas por número de publicaciones y actualidad

Herramientas de Mantenimiento

Herramientas para lidiar con la ejecución de la herramienta:

rebuild - Reconstruye el índice de contenido, útil si has agregado más contenido, editado contenido existente, etc.

Configuración / Instalación

Estas instrucciones describen la instalación para Claude Desktop en OS X. Debería funcionar de manera similar en otras plataformas.

Instala Claude Desktop.
Clona library-mcp en una ubicación conveniente, asumo /Users/will/library-mcp
Asegúrate de tener uv instalado, puedes seguir estas instrucciones

Ve a Claude Desktop, Configuración, Desarrollador, y haz que cree tu archivo de configuración MCP. Luego quieres actualizar tu claude_desktop_config.json. (Ten en cuenta que debes reemplazar will con tu usuario, por ejemplo, la salida de whoami.

 cd /Users/will/Library/Application Support/Claude
 vi claude_desktop_config.json

Luego agrega esta sección:

 {
   "mcpServers": {
     "library": {
       "command": "uv",
       "args": [
         "--directory",
         "/Users/will/library-mcp",
         "run",
         "main.py",
         "/Users/will/irrational_hugo/content"
       ]
     }
   }
 }

Cierra Claude y vuelve a abrirlo.
Debería funcionar...