DA

dawncr0w/affine-mcp-server

Productivity workflow

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

316 stars 85 forks 품질 88 트렌드 40MIT

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

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) and created-time (timestamp) columns from row metadata; missing or invalid metadata returns null without 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
GitHub에서 전체 README 보기

설치

npx -y -p affine-mcp-server affine-mcp -- --version
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "affine": { "type": "http", "url": "http://localhost:3000/mcp", "headers": { "Authorization": "Bearer your-strong-secret" } } } }