DA

dawncr0w/affine-mcp-server

Productivity workflow

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

316 stars 85 forks Качество 88 Тренд 40MIT

dawncr0w/affine-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/dawncr0w/affine-mcp-server.

Обзор

dawncr0w/affine-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/dawncr0w/affine-mcp-server.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для AFFiNE. Он предоставляет рабочие пространства и документы AFFiNE для AI-ассистентов по stdio (по умолчанию) или HTTP (/mcp) и поддерживает как AFFiNE Cloud, так и самостоятельные развертывания.

Содержание

  • Обзор
  • Выбери свой путь
  • Быстрый старт
  • Матрица совместимости
  • Поверхность инструмента
  • Документационная карта
  • Проверьте свою установку
  • Безопасность и область действия
  • Разработка
  • Примечания к релизу
  • Лицензия
  • Поддержка

Обзор

AFFiNE MCP Server разработан для трёх распространённых сценариев:

  • Запустить локальный stdio MCP сервер для Claude Code, Codex CLI, Cursor или Claude Desktop
  • Предоставить удалённый HTTP-MCP-конечный пункт для размещённых или подключённых к браузеру клиентов
  • Автоматизация рабочих процессов AFFiNE, документов, баз данных, организации и комментариев через стабильную поверхность инструмента MCP

Основные моменты:

  • Поддерживает облачные AFFiNE и самостоятельные экземпляры AFFiNE
  • Поддерживает stdio и HTTP-транспорты
  • Координирует одновременные записи в каждом рабочем пространстве через один общий MCP-сервер; опциональные версии документов отклоняют устаревшие правки
  • Поддерживает аутентификацию сессионных файлов cookie и электронной почты/паролей, а также совместимые токены носителей для старых развертываний

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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
Открыть полный README на GitHub

Установка

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