dengls24/annota

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

20 stars 1 forks 품질 69 트렌드 10MIT

Annota — AI-Powered Paper Annotation MCP Server. Reads PDFs, highlights findings, explains formulas, writes structured notes.

개요

AI reads your papers, highlights key findings, explains formulas, and writes structured notes — all saved back to your reference manager. AI generates a structured reading summary with key findings, methods, and conclusions - — Reads full text first (cheap), then only gets coordinates for target sentences (precise). Reduces context usage by 63–80%. - — Detects "References" section and skips it. A 21-page paper extracts only 13 pages. - — Creates 10 highlights in 1 API call instead of 10. - — Write failures return helpful messages instead of crashing. Add to ~/.claude.json (or via Claude Code Settings > MCP Servers): - : Zotero → Edit → Settings → Advanced → Data Directory Location (default: C:\Users\YourName\Zotero) - : Zotero → Settings → Advanced → Data Directory Location (default: ~/Zotero) - : default ~/Zotero Drag a file from Finder into the terminal to get its full path, or right-click → "Copy as Pathname".

README

원문 README의 일부입니다. 원문 보기.

What Can It Do?

You say…	AI does…
“高亮摘要中的发现结果” (Highlight findings in the abstract)	Reads the abstract, identifies findings, highlights them in green
“解释第3页的公式” (Explain the formulas on page 3)	Extracts the formula, adds an explanation as a note annotation
“写一份结构化阅读笔记” (Write a structured reading note)	Generates a note with contributions, methods, results, limitations — saved to your library
“以 MICRO 审稿人视角审阅” (Review as a MICRO reviewer)	Produces a structured review with scores and actionable feedback

✨ Features

9 MCP Tools

Tool	What it does
`search_zotero_items`	Search by title / author / key
`list_zotero_items`	Browse recent items
`get_item_metadata`	Get authors, year, venue, DOI
`get_pdf_text_bulk`	Extract full text (no coords, fast)
`get_pdf_layout_text`	Extract text + precise coordinates
`list_annotations`	View existing annotations
`create_pdf_annotation`	Create highlight / underline
`batch_annotate`	Create multiple annotations at once
`add_child_note`	Add a note to any item

3 Claude Code Skills (Slash Commands)

Command	Function
`/annota-annotate`	Smart annotation with semantic color coding
`/annota-summarize`	Structured reading notes saved to your library
`/annota-review`	Simulated peer review with scoring rubric

Smart Design

Two-phase workflow — Reads full text first (cheap), then only gets coordinates for target sentences (precise). Reduces context usage by 63–80%.
Auto-skip references — Detects “References” section and skips it. A 21-page paper extracts only 13 pages.
Batch annotations — Creates 10 highlights in 1 API call instead of 10.
Friendly errors — Write failures return helpful messages instead of crashing.

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "annota": {
      "command": "C:/path/to/annota/.venv/Scripts/python.exe",
      "args": ["C:/path/to/annota/annota/server.py"],
      "env": {
        "ZOTERO_DATA_DIR": "C:/Users/YourName/Zotero"
      }
    }
  }
}