book-notes-mcp

Una base de conocimientos que permite gestionar notas de lectura de libros de negocios en formato YAML estructurado y buscarlas/referenciarlas desde agentes de IA a través de un servidor MCP.

Características

• No depende en absoluto de APIs de LLM ($0 al mes)

• Diseño de seguridad basado en repositorios públicos de GitHub

• Búsqueda de texto completo en japonés e inglés mediante SQLite FTS5

• Accesible desde agentes de IA mediante 7 herramientas MCP

Inicio rápido

git clone https://github.com/YOUR_NAME/book-notes-mcp
cd book-notes-mcp
npm ci --ignore-scripts

# インデックスを構築
npm run index build

# Claude Desktop に MCP サーバーを登録
# ~/.config/claude/claude_desktop_config.json に追記:

{
  "mcpServers": {
    "book-notes": {
      "command": "npx",
      "args": ["tsx", "/path/to/book-notes-mcp/mcp-server/src/index.ts"],
      "env": { "DB_PATH": "/path/to/book-notes-mcp/books.db" }
    }
  }
}

Uso

1. Estructurar las notas de lectura

# inbox/ に走り書きを置く（gitignore対象）
cp your-notes.md inbox/

# 手元の AI CLI で YAML を生成
cat prompts/structure.md inbox/your-notes.md | claude > books/your-book-author-2024.yaml

# 検証・整形
npm run validate -- books/your-book-author-2024.yaml
npm run format -- books/your-book-author-2024.yaml

# インデックス更新
npm run index build

2. Comandos CLI

npm run validate -- books/           # スキーマ検証
npm run validate -- books/ --strict  # 引用文字数エラーも検出
npm run format -- books/             # YAML 整形
npm run index build                  # SQLite インデックス構築
npm run check-refs                   # connections の参照整合性チェック

3. Herramientas MCP

Formato YAML de entrada de libro

Cada archivo YAML en el directorio books/ corresponde a un libro.

Nombre del archivo: {title-slug}-{author-family}-{year}.yaml (ej: atomic-habits-clear-2018.yaml)

Consulte schema/book-entry.schema.json para más detalles.

Seguridad

• Las notas sin procesar en inbox/ están incluidas en .gitignore (no se incluyen en el repositorio público)

• Bloqueo de paquetes maliciosos a nivel de registro mediante Takumi Guard (npm.flatt.tech)

• Todos los GitHub Actions están fijados por commit SHA

• El servidor MCP utiliza solo stdio, SQLite es de solo lectura

Consulte SECURITY.md para más detalles.

Licencia

• Código (src/, mcp-server/, schema/): Licencia MIT

• Contenido (books/, topics/): CC-BY-NC-4.0