Skip to main content
Glama
deenesjakoruzh
sotanengel

book-notes-mcp

by sotanengel
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

book-notes-mcp

一个知识库，用于管理结构化 YAML 格式的商业书籍阅读笔记，并通过 MCP 服务器供 AI 智能体搜索和引用。

特点

  • 完全不依赖 LLM API（每月 $0）

  • 基于 GitHub 公开仓库的安全设计

  • 基于 SQLite FTS5 的日英文全文搜索

  • 提供 7 个 MCP Tool 供 AI 智能体调用

快速开始

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 Tools

工具

说明

list_books

带过滤条件的藏书列表

get_book

获取单本书籍详情

search_books

全文搜索（标题、作者、摘要）

search_highlights

跨书重点摘要搜索

search_concepts

跨书概念搜索

find_connections

相关书籍图谱（深度 1 或 2）

get_actionable_insights

提取可执行建议

书籍条目 YAML 格式

books/ 目录下的每个 YAML 文件对应一本书。

文件名: {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。

许可证

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Resources

Related MCP Connectors