Content
# MCP Biblioteca Pessoal
Servidor MCP neutro em Java/Spring Boot para demonstrar tools via stdio com uma biblioteca pessoal mockada.
O projeto evita qualquer dominio sensivel: sem juridico, scraping, empresa, cliente, API real ou dado privado.
## Rodar
```powershell
cd mcp-biblioteca-pessoal
mvn clean test
mvn package
java -jar target\mcp-biblioteca-pessoal-1.0.0.jar
```
O servidor usa stdio. O stdout e o canal JSON-RPC do MCP, entao banner e logs ficam desligados.
## Tools
- `buscar_livro(consulta)`: busca por id ou trecho do titulo.
- `listar_livros(status?, tag?, genero?, limite?)`: lista livros com filtros simples.
- `recomendar_proxima_leitura(interesse)`: recomenda ate 5 livros por tags, genero, titulo e resumo.
## Exemplos
- "Quais livros de filosofia tenho na biblioteca?"
- "Busca livros com viagem no titulo."
- "Recomenda uma proxima leitura curta e classica."
- "Estou lendo o que agora?"
## Codex
```toml
[mcp_servers.biblioteca-pessoal]
command = "java"
args = ["-jar", "mcp-biblioteca-pessoal\\target\\mcp-biblioteca-pessoal-1.0.0.jar"]
```
## Claude Desktop
```json
{
"mcpServers": {
"biblioteca-pessoal": {
"command": "java",
"args": [
"-jar",
"mcp-biblioteca-pessoal\\target\\mcp-biblioteca-pessoal-1.0.0.jar"
]
}
}
}
```