
dawncr0w/affine-mcp-server
Productivity workflow이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
dawncr0w/affine-mcp-server는 https://github.com/dawncr0w/affine-mcp-server.에서 가져온 MCP 서버 후보입니다.
개요
dawncr0w/affine-mcp-server는 https://github.com/dawncr0w/affine-mcp-server.에서 가져온 MCP 서버 후보입니다.
개요(AI 번역)
AFFiNE용 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 기본(stdio) 또는 HTTP(/mcp)를 통해 AFFiNE 작업 공간과 문서를 AI 어시스턴트에게 노출하며, AFFiNE 클라우드와 자체 호스팅 배포를 모두 지원합니다.
목차
- 개요
- 선택하세요
- 퀵 스타트
- 호환성 매트릭스
- 공구 표면
- 문서 지도
- 설정 검증
- 보안 및 범위
- 개발
- 출시 노트
- 면허
- 지원
개요
AFFiNE MCP 서버는 세 가지 일반적인 시나리오를 위해 설계되었습니다:
- Claude Code, Codex CLI, Cursor, 또는 Claude 데스크톱용 로컬 stdio MCP 서버 실행
- 호스팅 또는 브라우저 연결 클라이언트를 위해 원격 HTTP MCP 엔드포인트를 노출
- 안정적인 MCP 툴 서피스를 통해 AFFiNE 작업 공간, 문서, 데이터베이스, 조직, 주석 워크플로우를 자동화합니다
주요 내용:
- AFFiNE 클라우드 및 자체 호스팅 AFFiNE 인스턴스 지원
- stdio 및 HTTP 전송 지원
- 하나의 공유 MCP 서버를 통해 작업 공간별 동시 쓰기를 좌표화합니다; 선택적 문서 수정은 오래된 편집을 거부합니다
- 세션 쿠키 및 이메일/비밀번호 인증, 그리고 구형 배포를 위한 호환 베어러 토큰 지원
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
AFFiNE MCP Server
A Model Context Protocol (MCP) server for AFFiNE. It exposes AFFiNE workspaces and documents to AI assistants over stdio (default) or HTTP (/mcp) and supports both AFFiNE Cloud and self-hosted deployments.
Table of Contents
- Overview
- Choose Your Path
- Quick Start
- Compatibility Matrix
- Tool Surface
- Documentation Map
- Verify Your Setup
- Security and Scope
- Development
- Release Notes
- License
- Support
Overview
AFFiNE MCP Server is designed for three common scenarios:
- Run a local stdio MCP server for Claude Code, Codex CLI, Cursor, or Claude Desktop
- Expose a remote HTTP MCP endpoint for hosted or browser-connected clients
- Automate AFFiNE workspace, document, database, organization, and comment workflows through a stable MCP tool surface
Highlights:
- Supports AFFiNE Cloud and self-hosted AFFiNE instances
- Supports stdio and HTTP transports
- Coordinates concurrent writes per workspace through one shared MCP server; optional document revisions reject stale edits
- Supports session-cookie and email/password authentication, plus compatible bearer tokens for older deployments
- Exposes 107 canonical MCP tools backed by AFFiNE GraphQL and WebSocket APIs
- Reads native database
created-by(user ID) andcreated-time(timestamp) columns from row metadata; missing or invalid metadata returnsnullwithout backfilling it - Sets and clears native AFFiNE Journal dates with
set_doc_journal - Includes semantic page composition, native template instantiation, database intent composition, capability and fidelity reporting, and workspace blueprint helpers
- Includes Docker images, health probes, and end-to-end test coverage
Scope boundaries:
- This server can access only server-backed AFFiNE workspaces
- Browser-local workspaces stored only in local storage are not available through AFFiNE server APIs
설치
npx -y -p affine-mcp-server affine-mcp -- --version설정
{
"mcpServers": {
"affine": {
"type": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer your-strong-secret"
}
}
}
}