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 에이전트에서 액세스 가능

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 Tools

Tool

설명

list_books

필터가 포함된 도서 목록

get_book

도서 1권의 상세 정보 조회

search_books

전체 텍스트 검색 (제목, 저자, 요약)

search_highlights

하이라이트 교차 검색

search_concepts

개념 교차 검색

find_connections

관련 도서 그래프 (depth 1 또는 2)

get_actionable_insights

실행 가능한 인사이트 추출

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를 참조하세요.

라이선스

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Resources

Related MCP Connectors