book-notes-mcp

База знаний, позволяющая управлять заметками о бизнес-книгах в структурированном формате YAML и искать/ссылаться на них через MCP-сервер с помощью ИИ-агентов.

Особенности

• Полная независимость от LLM API ($0 в месяц)

• Дизайн безопасности, ориентированный на публичные репозитории GitHub

• Полнотекстовый поиск на японском и английском языках с использованием SQLite FTS5

• Доступ для ИИ-агентов через 7 инструментов MCP

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

Использование

1. Структурирование заметок о прочитанных книгах

# 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-команды

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

Формат YAML для записей о книгах

Каждый YAML-файл в директории books/ соответствует одной книге.

Имя файла: {title-slug}-{author-family}-{year}.yaml (например: atomic-habits-clear-2018.yaml)

Подробности см. в schema/book-entry.schema.json.

Безопасность

• Необработанные заметки в inbox/ включены в .gitignore (не попадают в публичный репозиторий)

• Блокировка вредоносных пакетов на уровне реестра с помощью Takumi Guard (npm.flatt.tech)

• Все GitHub Actions закреплены по commit SHA

• MCP-сервер работает только через stdio, SQLite используется в режиме «только для чтения»

Подробности см. в SECURITY.md.

Лицензия

• Код (src/, mcp-server/, schema/): MIT License

• Контент (books/, topics/): CC-BY-NC-4.0