DAWNCR0W/affine-mcp-server

解決する課題

このプロジェクトは、AFFiNE 生産性プラットフォームと AI アシスタントの間のブリッジとして機能します。AI モデル（Claude Desktop、Cursor、Codex など）が、Model Context Protocol（MCP）を通じて AFFiNE ワークスペース、ドキュメント、データベース、コメントを直接読み取り、書き込み、管理できるようにします。

仕組み

サーバーは、認証情報を使用して AFFiNE インスタンス（クラウドまたはセルフホスト）に接続します。MCP 標準を介して 100 以上のツールを公開し、AI エージェントはこれらを呼び出して、ページの作成、データベース行の更新、ノートの検索などのタスクを実行できます。ローカルデスクトップ AI ツール用の stdio モードと、リモートまたはコンテナ化されたデプロイメント用の HTTP モードの 2 つのモードをサポートしています。

対象読者

AI エージェントを AFFiNE ワークフローに直接統合したいパワーユーザーと開発者向けに設計されており、ドキュメントの自動作成、データベース管理、ワークスペースの整理を可能にします。

ハイライト

• AFFiNE Cloud とセルフホストデプロイメントの両方をサポート。
• 包括的なワークスペース管理のための 100 以上の標準 MCP ツールを提供。
• セッション Cookie やセルフホストインスタンス用のメール/パスワードなど、柔軟な認証を提供。
• 読み取り専用プロファイルや無効化されたツールグループなど、最小特権アクセスのための堅牢な構成オプションを含む。
• Docker とリモートサーバーデプロイメントのヘルスモニタリングのための組み込みサポートを備えています。