book-notes-mcp
Enables structured book note management in a GitHub repository with security-focused design, using GitHub for version control and repository hosting of the knowledge base content.
Supports GitHub Actions workflows for automated validation, formatting, and indexing of book notes with commit SHA pinning for security in the repository.
Utilizes SQLite with FTS5 for full-text search capabilities across Japanese and English content in the book notes database, enabling efficient querying of titles, authors, summaries, highlights, and concepts.
Manages structured book notes in YAML format with schema validation and formatting tools, providing a standardized way to organize book metadata, highlights, concepts, and connections.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@book-notes-mcpsearch for books about productivity and habits"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
book-notes-mcp
ビジネス書の読書ノートを構造化 YAML で管理し、MCP サーバー経由で AI エージェントから検索・参照できるナレッジベース。
特徴
LLM API に一切依存しない（月 $0）
GitHub 公開リポジトリ前提のセキュリティ設計
SQLite FTS5 による日英全文検索
7 つの MCP Tool で AI エージェントからアクセス可能
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 build2. 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 Tools
Tool | 説明 |
| フィルタ付き蔵書一覧 |
| 1 冊の詳細取得 |
| 全文検索（タイトル・著者・サマリー） |
| ハイライト横断検索 |
| 概念横断検索 |
| 関連書籍グラフ（depth 1 or 2） |
| アクションアイテム抽出 |
Book Entry YAML フォーマット
books/ ディレクトリの各 YAML ファイルが 1 冊に対応します。
ファイル名: {title-slug}-{author-family}-{year}.yaml（例: atomic-habits-clear-2018.yaml）
詳細は schema/book-entry.schema.json を参照。
セキュリティ
inbox/の Raw Note は.gitignore対象（公開リポジトリに含まれません）Takumi Guard (npm.flatt.tech) によるレジストリレベルの悪性パッケージブロック
全 GitHub Actions を commit SHA でピン留め
MCP サーバーは stdio のみ、SQLite は読み取り専用
詳細は SECURITY.md を参照。
ライセンス
Code (
src/,mcp-server/,schema/): MIT LicenseContent (
books/,topics/): CC-BY-NC-4.0
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sotanengel/book-notes-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server