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 "Deploy 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
A knowledge base that manages business book notes in structured YAML, allowing AI agents to search and reference them via an MCP server.
Features
Zero dependency on LLM APIs ($0/month)
Security design based on public GitHub repositories
Japanese/English full-text search using SQLite FTS5
Accessible by AI agents via 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" }
}
}
}Usage
1. Structure your book notes
# 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 Commands
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 | Description |
| List books with filters |
| Get details for a single book |
| Full-text search (title, author, summary) |
| Cross-reference search for highlights |
| Cross-reference search for concepts |
| Related book graph (depth 1 or 2) |
| Extract actionable items |
Book Entry YAML Format
Each YAML file in the books/ directory corresponds to one book.
Filename: {title-slug}-{author-family}-{year}.yaml (e.g., atomic-habits-clear-2018.yaml)
See schema/book-entry.schema.json for details.
Security
Raw notes in
inbox/are included in.gitignore(not included in public repositories)Registry-level malicious package blocking via Takumi Guard (npm.flatt.tech)
All GitHub Actions pinned by commit SHA
MCP server uses stdio only; SQLite is read-only
See SECURITY.md for details.
License
Code (
src/,mcp-server/,schema/): MIT LicenseContent (
books/,topics/): CC-BY-NC-4.0
Related MCP Connectors
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
The CustomGPT.ai MCP server is a fully managed, RAG-powered endpoint that connects large language models with private knowledge bases and external data sources. It provides tools for retrieval-augmented generation queries (send_message), data ingestion (upload_file), and source listing, enabling AI agents to query private documents like PDFs with high accuracy and real-time citations.
Knowledge base MCP for AI agents on iknow.dev. Search, read, and maintain via OAuth.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
