mcp-readwise

FastMCP 기반으로 구축된 Readwise용 MCP 서버입니다. 하이라이트, 도서, 태그, Reader 문서 및 대량 내보내기를 포함하는 17가지 도구를 제공합니다.

설치

uv sync

또는 pip 사용:

pip install .

Related MCP server: Kiseki-Labs-Readwise-MCP

구성

다음 환경 변수를 설정하십시오:

변수	필수	기본값	설명
`READWISE_TOKEN`	예	-	Readwise API 액세스 토큰
`TRANSPORT`	아니요	`stdio`	전송 모드: `stdio` 또는 `http`
`HOST`	아니요	`127.0.0.1`	HTTP 서버 호스트
`PORT`	아니요	`8000`	HTTP 서버 포트
`MCP_API_KEY`	아니요	-	MCP 포털 인증을 위한 Bearer 토큰
`READWISE_BASE_URL`	아니요	`https://readwise.io`	Readwise API 기본 URL

Readwise 액세스 토큰은 다음에서 확인하세요: https://readwise.io/access_token

사용법

로컬 (stdio)

READWISE_TOKEN=your_token uv run mcp-readwise

HTTP 모드

READWISE_TOKEN=your_token TRANSPORT=http uv run mcp-readwise

Docker

cp .env.example .env  # Add your READWISE_TOKEN
docker compose up -d

사용 가능한 도구

하이라이트

도구	설명
`search_highlights`	의미론적, 전체 텍스트 또는 하이브리드 모드를 사용하여 검색
`list_highlights`	필터(도서, 태그, 날짜) 및 페이지 매김을 사용하여 목록 표시
`get_highlight`	도서 메타데이터와 함께 ID로 가져오기
`create_highlight`	선택적 메모/태그와 함께 도서에 생성
`update_highlight`	텍스트 또는 메모 업데이트
`delete_highlight`	ID로 삭제
`export_highlights`	커서 페이지 매김을 사용한 대량 내보내기

도서

도구	설명
`list_books`	카테고리/소스/주석 필터를 사용하여 목록 표시
`get_book`	ID로 가져오기

Reader

도구	설명
`list_documents`	위치/카테고리 필터를 사용하여 Reader 문서 목록 표시
`get_document`	전체 콘텐츠와 함께 ID로 가져오기
`save_url`	URL을 Reader에 저장
`update_progress`	읽기 진행률 업데이트 (0.0-1.0)

프로젝트 구조

mcp_readwise/
  server.py      # FastMCP app, tool registration, entry point
  config.py      # pydantic-settings configuration
  client.py      # Centralized httpx client (auth, retries, rate limits)
  auth.py        # Bearer token verifier for MCP Portal
  models/        # Pydantic response models
  tools/         # Tool functions by domain

배포

Komodo를 통해 ubuntu-smurf-mirror에 배포되었으며, mcp-readwise.cdit-dev.de의 Cloudflare MCP 포털을 통해 액세스할 수 있습니다.

라이선스

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

도구	설명
`list_tags`	모든 태그 목록 표시
`create_tag`	새 태그 생성
`delete_tag`	ID로 삭제
`tag_highlight`	하이라이트에 태그 추가 또는 제거

Readwise MCP HTTP Server