book-notes-mcp

Eine Wissensdatenbank, die Lese-Notizen zu Wirtschaftsbüchern in strukturiertem YAML verwaltet und über einen MCP-Server für KI-Agenten durchsuchbar und referenzierbar macht.

Merkmale

• Völlig unabhängig von LLM-APIs ($0 pro Monat)

• Sicherheitsdesign für öffentliche GitHub-Repositories

• Japanische und englische Volltextsuche mittels SQLite FTS5

• Zugriff für KI-Agenten über 7 MCP-Tools

Quick Start

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" }
    }
  }
}

Verwendung

1. Lese-Notizen strukturieren

# 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. CLI-Befehle

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. MCP-Tools

YAML-Format für Bucheinträge

Jede YAML-Datei im Verzeichnis books/ entspricht einem Buch.

Dateiname: {title-slug}-{author-family}-{year}.yaml (z. B. atomic-habits-clear-2018.yaml)

Weitere Details finden Sie unter schema/book-entry.schema.json.

Sicherheit

• Raw-Notizen in inbox/ sind in .gitignore enthalten (nicht im öffentlichen Repository enthalten)

• Blockierung schädlicher Pakete auf Registry-Ebene durch Takumi Guard (npm.flatt.tech)

• Alle GitHub Actions sind per Commit-SHA fixiert

• MCP-Server nutzt nur stdio, SQLite ist schreibgeschützt

Weitere Details finden Sie unter SECURITY.md.

Lizenz

• Code (src/, mcp-server/, schema/): MIT License

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