dawncr0w/affine-mcp-server

Productivity workflow

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

316 stars 85 forks 品質 88 トレンド 40MIT

Repository Install

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)サーバーです。AFFiNEワークスペースやドキュメントを標準(デフォルト)またはHTTP(/mcp)経由でAIアシスタントに公開し、AFFiNEクラウドおよびセルフホスト展開の両方をサポートしています。

概要

AFFiNE MCPサーバーは、以下の3つの一般的なシナリオ向けに設計されています。

Claude Code、Codex CLI、Cursor、またはClaude Desktop用のローカルスタンディオMCPサーバーを実行
ホストまたはブラウザ接続クライアント向けにリモートHTTP MCPエンドポイントを公開する
安定したMCPツールサーフェスを通じてAFFiNEのワークスペース、ドキュメント、データベース、組織化、コメントワークフローを自動化

ハイライト:

AFFiNEクラウドおよびセルフホスト型AFFiNEインスタンスのサポート
スタンディオおよびHTTPトランスポートのサポート
1つの共有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.

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) 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"
      }
    }
  }
}