Library MCP

Um servidor local para consultar e interagir com bases de conhecimento Mark

Documentação

library-mcp é um servidor MCP para interagir com bases de conhecimento Markdown. Basicamente, pastas que podem ou não ter subpastas, que incluem arquivos com extensão .md e começam com metadados como:

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

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

O fluxo de trabalho típico na versão atual é recuperar conteúdo recente para uma determinada tag e depois discutir usando essa tag:

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

Você também pode fazer o mesmo por intervalos de datas:

Summarize the blog posts I wrote in the past year.

Você pode razoavelmente perguntar "por que não enviar todo o seu blog para a janela de contexto?" e há dois lugares onde esta biblioteca supera essa abordagem:

Meu corpus de blog é muito maior do que as janelas de contexto da maioria dos modelos hoje. Além disso, mesmo que as janelas de contexto se tornassem exaustivamente grandes, eu escrevi muitas coisas medíocres no passado, então talvez omitir seja uma característica.
Tenho várias bases de conhecimento Markdown distintas, e isso me permite operar em todas elas em conjunto.

Finalmente, este é um projeto de hobby, destinado a ser executado localmente no seu laptop. Nenhum ser humano foi prejudicado usando este software, mas funciona muito bem!

Ferramentas

Este servidor MCP expõe estas ferramentas.

Ferramentas de Busca de Conteúdo

Ferramentas para recuperar conteúdo para a sua janela de contexto:

get_by_tag - Recupera conteúdo por tag
get_by_text - Pesquisa conteúdo por texto específico
get_by_slug_or_url - Encontra posts por slug ou URL
get_by_date_range - Obtém posts publicados em um intervalo de datas

Ferramentas de Gerenciamento de Tags

Ferramentas para navegar pela sua base de conhecimento:

search_tags - Pesquisa tags que correspondem a uma consulta
list_all_tags - Lista todas as tags ordenadas por contagem de posts e recência

Ferramentas de Manutenção

Ferramentas para lidar com a execução da ferramenta:

rebuild - Reconstrói o índice de conteúdo, útil se você adicionou mais conteúdo, editou conteúdo existente, etc

Configuração / Instalação

Estas instruções descrevem a instalação para Claude Desktop no OS X. Deve funcionar de forma semelhante em outras plataformas.

Instale Claude Desktop.
Clone library-mcp em um local conveniente, estou assumindo /Users/will/library-mcp
Certifique-se de ter o uv instalado, você pode seguir estas instruções

Vá para Claude Desktop, Configurações, Desenvolvedor, e peça para criar seu arquivo de configuração MCP. Então você precisa atualizar seu claude_desktop_config.json. (Note que você deve substituir will pelo seu usuário, por exemplo, o resultado de whoami.

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

Então adicione esta seção:

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

Feche o Claude e reabra.
Deve funcionar...