@mtcsistemas/appflowy-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AppFlowy Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,324 @@
+<div align="center">
+
+# 🚀 AppFlowy MCP Server
+
+**Connect your IDE to your self-hosted AppFlowy workspace**
+
+[![npm version](https://img.shields.io/npm/v/@appflowy/mcp-server.svg)](https://www.npmjs.com/package/@appflowy/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
+
+[Installation](#installation) • [Configuration](#configuration) • [Tools](#available-tools) • [File Attachments](#file-attachments)
+
+</div>
+
+---
+
+## ✨ Features
+
+- 🔍 **Full-text search** across all workspace content
+- 📄 **Document management** — read, create, delete pages
+- 📊 **Database operations** — CRUD on Grid, Board, Calendar, Gallery
+- 📎 **File attachments** — upload, download, attach files to documents
+- 🌐 **Works with any MCP-compatible IDE** — VS Code, Cursor, Claude Desktop, Zed, and more
+- 🔐 **Secure JWT authentication** via GoTrue (Supabase Auth fork)
+- 🏠 **Self-hosted first** — designed for AppFlowy Cloud self-hosted instances
+
+---
+
+## 📦 Installation
+
+### Option 1: Install via npx (recommended)
+
+```bash
+npx @appflowy/mcp-server
+```
+
+### Option 2: Install globally
+
+```bash
+npm install -g @appflowy/mcp-server
+```
+
+### Option 3: Clone and build from source
+
+```bash
+git clone https://github.com/AppFlowy-IO/appflowy-mcp-server.git
+cd appflowy-mcp-server
+npm install
+npm run build
+```
+
+---
+
+## ⚙️ Configuration
+
+Create a `.env` file or set environment variables:
+
+```bash
+# Required: Your AppFlowy Cloud URL
+APPFLOWY_BASE_URL=https://tu-appflowy.dominio.com
+
+# Authentication (choose one method)
+
+# Method 1: Email + Password
+APPFLOWY_EMAIL=admin@tu-dominio.com
+APPFLOWY_PASSWORD=tu-password-seguro
+
+# Method 2: Pre-generated JWT Token
+# APPFLOWY_JWT_TOKEN=eyJhbGciOiJIUzI1NiIs...
+
+# Optional: File upload limits
+APPFLOWY_MAX_FILE_SIZE_MB=50
+APPFLOWY_FILE_TIMEOUT_SEC=60
+```
+
+### Getting your JWT Token
+
+1. Log in to your AppFlowy web app
+2. Open browser DevTools → Application → Local Storage
+3. Find the `gotrue` token or call:
+   ```bash
+   curl -X POST https://tu-appflowy.dominio.com/gotrue/token?grant_type=password \
+     -H "Content-Type: application/json" \
+     -d '{"email":"your@email.com","password":"your-password"}'
+   ```
+
+---
+
+## 🖥️ IDE Setup
+
+### VS Code
+
+Add to your `settings.json`:
+
+```json
+{
+  "mcp.servers": {
+    "appflowy": {
+      "command": "npx",
+      "args": ["-y", "@appflowy/mcp-server"],
+      "env": {
+        "APPFLOWY_BASE_URL": "https://tu-appflowy.dominio.com",
+        "APPFLOWY_EMAIL": "admin@tu-dominio.com",
+        "APPFLOWY_PASSWORD": "tu-password-seguro"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+In **Settings → MCP Servers**, add:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "appflowy",
+      "command": "npx -y @appflowy/mcp-server",
+      "env": {
+        "APPFLOWY_BASE_URL": "https://tu-appflowy.dominio.com",
+        "APPFLOWY_EMAIL": "admin@tu-dominio.com",
+        "APPFLOWY_PASSWORD": "tu-password-seguro"
+      }
+    }
+  ]
+}
+```
+
+### Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "appflowy": {
+      "command": "npx",
+      "args": ["-y", "@appflowy/mcp-server"],
+      "env": {
+        "APPFLOWY_BASE_URL": "https://tu-appflowy.dominio.com",
+        "APPFLOWY_JWT_TOKEN": "eyJhbGciOiJIUzI1NiIs..."
+      }
+    }
+  }
+}
+```
+
+### Zed
+
+Add to your `settings.json`:
+
+```json
+{
+  "assistant": {
+    "version": "2",
+    "default_model": {
+      "provider": "anthropic",
+      "model": "claude-3-5-sonnet-latest"
+    },
+    "enable_experimental_live_diffs": true
+  },
+  "context_servers": {
+    "appflowy-mcp-server": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "@appflowy/mcp-server"],
+        "env": {
+          "APPFLOWY_BASE_URL": "https://tu-appflowy.dominio.com",
+          "APPFLOWY_EMAIL": "admin@tu-dominio.com",
+          "APPFLOWY_PASSWORD": "tu-password-seguro"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🛠️ Available Tools
+
+### Workspace Tools
+
+| Tool | Description |
+|------|-------------|
+| `appflowy_list_workspaces` | List all available workspaces |
+| `appflowy_get_workspace` | Get details of a specific workspace |
+
+### Document Tools
+
+| Tool | Description |
+|------|-------------|
+| `appflowy_list_documents` | List documents in a workspace/folder |
+| `appflowy_read_document` | Read full content of a document |
+| `appflowy_create_document` | Create a new document/page |
+| `appflowy_delete_document` | Delete a document |
+| `appflowy_duplicate_document` | Duplicate/clone a document |
+
+### Database Tools
+
+| Tool | Description |
+|------|-------------|
+| `appflowy_list_databases` | List all databases (Grid, Board, Calendar, Gallery) |
+| `appflowy_read_database` | Read all rows from a database |
+| `appflowy_create_database_row` | Create a new row |
+| `appflowy_update_database_row` | Update an existing row |
+| `appflowy_delete_database_row` | Delete a row |
+
+### Search Tools
+
+| Tool | Description |
+|------|-------------|
+| `appflowy_search` | Full-text search across workspace content |
+
+### File Attachment Tools
+
+| Tool | Description |
+|------|-------------|
+| `appflowy_upload_file` | Upload a file to AppFlowy storage |
+| `appflowy_download_file` | Download a file to your local machine |
+| `appflowy_list_files` | List files in storage |
+| `appflowy_delete_file` | Delete a file from storage |
+| `appflowy_attach_file_to_document` | Attach a file to a document |
+
+---
+
+## 📎 File Attachments
+
+Upload files from your local machine and attach them to AppFlowy documents:
+
+```
+"Upload the file /home/user/report.pdf to my AppFlowy workspace"
+→ Uses appflowy_upload_file
+
+"Attach the uploaded report to the Sprint Review document"
+→ Uses appflowy_attach_file_to_document
+
+"Download the file with ID abc123 to /home/user/downloads"
+→ Uses appflowy_download_file
+```
+
+### Supported File Types
+
+- **Images**: PNG, JPG, GIF, SVG, WebP
+- **Documents**: PDF, DOCX, TXT, MD
+- **Code files**: JS, TS, PY, JSON, YAML, etc.
+- **Archives**: ZIP, TAR, GZ
+- **Any file type** up to the configured max size (default: 50MB)
+
+---
+
+## 💡 Usage Examples
+
+### Find documentation
+```
+"Search in AppFlowy for documents about API architecture"
+→ appflowy_search(query="API architecture")
+```
+
+### Create meeting notes
+```
+"Create meeting notes for today's standup in AppFlowy"
+→ appflowy_create_document(name="Standup - 2026-06-13")
+```
+
+### Manage tasks
+```
+"Show me all pending tasks in the project database"
+→ appflowy_read_database → filter by status
+```
+
+### Upload and attach files
+```
+"Upload the design mockup.png and attach it to the Design Specs document"
+→ appflowy_upload_file → appflowy_attach_file_to_document
+```
+
+---
+
+## 🔧 Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Test with MCP Inspector
+npm run inspector
+```
+
+---
+
+## 🐛 Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| `ECONNREFUSED` | Check that AppFlowy Cloud is running and `APPFLOWY_BASE_URL` is correct |
+| Authentication failed | Verify email/password or regenerate JWT token |
+| Workspace not found | Run `appflowy_list_workspaces` to get valid IDs |
+| File upload too large | Increase `APPFLOWY_MAX_FILE_SIZE_MB` |
+| Token expired | The server auto-refreshes tokens; if issues persist, restart the IDE |
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
+
+Made with ❤️ for the AppFlowy community
+
+[AppFlowy](https://appflowy.com) • [GitHub](https://github.com/AppFlowy-IO) • [Discord](https://discord.gg/9Q2xaN37tV)
+
+</div>

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AppFlowy MCP Server - Configuration
+ * Environment variables and validation
+ */
+import { AppFlowyConfig, McpServerConfig } from './types.js';
+export declare const APPFLOWY_CONFIG: AppFlowyConfig;
+export declare const MCP_CONFIG: McpServerConfig;
+/**
+ * Validate required configuration
+ * @throws Error if configuration is invalid
+ */
+export declare function validateConfig(): void;
+/**
+ * Get the GoTrue authentication URL
+ */
+export declare function getGoTrueUrl(): string;
+/**
+ * Get the AppFlowy API base URL
+ */
+export declare function getApiUrl(): string;
+/**
+ * Get the file storage API URL
+ */
+export declare function getFileStorageUrl(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAK7D,eAAO,MAAM,eAAe,EAAE,cAO7B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAGxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAiBrC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/config.js

@@ -0,0 +1,56 @@
+/**
+ * AppFlowy MCP Server - Configuration
+ * Environment variables and validation
+ */
+import { config } from 'dotenv';
+// Load environment variables from .env file
+config();
+export const APPFLOWY_CONFIG = {
+    baseUrl: process.env.APPFLOWY_BASE_URL?.replace(/\/$/, '') || 'http://localhost:80',
+    email: process.env.APPFLOWY_EMAIL || '',
+    password: process.env.APPFLOWY_PASSWORD || '',
+    jwtToken: process.env.APPFLOWY_JWT_TOKEN || '',
+    maxFileSizeMB: parseInt(process.env.APPFLOWY_MAX_FILE_SIZE_MB || '50', 10),
+    fileTimeoutSec: parseInt(process.env.APPFLOWY_FILE_TIMEOUT_SEC || '60', 10),
+};
+export const MCP_CONFIG = {
+    serverName: process.env.MCP_SERVER_NAME || 'appflowy-mcp-server',
+    serverVersion: process.env.MCP_SERVER_VERSION || '1.0.0',
+};
+/**
+ * Validate required configuration
+ * @throws Error if configuration is invalid
+ */
+export function validateConfig() {
+    const errors = [];
+    if (!APPFLOWY_CONFIG.baseUrl) {
+        errors.push('APPFLOWY_BASE_URL is required');
+    }
+    const hasJwt = !!APPFLOWY_CONFIG.jwtToken;
+    const hasCredentials = !!(APPFLOWY_CONFIG.email && APPFLOWY_CONFIG.password);
+    if (!hasJwt && !hasCredentials) {
+        errors.push('Authentication required: provide either APPFLOWY_JWT_TOKEN or APPFLOWY_EMAIL + APPFLOWY_PASSWORD');
+    }
+    if (errors.length > 0) {
+        throw new Error(`Configuration errors:\n${errors.map(e => `  - ${e}`).join('\n')}`);
+    }
+}
+/**
+ * Get the GoTrue authentication URL
+ */
+export function getGoTrueUrl() {
+    return `${APPFLOWY_CONFIG.baseUrl}/gotrue`;
+}
+/**
+ * Get the AppFlowy API base URL
+ */
+export function getApiUrl() {
+    return `${APPFLOWY_CONFIG.baseUrl}/api`;
+}
+/**
+ * Get the file storage API URL
+ */
+export function getFileStorageUrl() {
+    return `${APPFLOWY_CONFIG.baseUrl}/api/file_storage`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,4CAA4C;AAC5C,MAAM,EAAE,CAAC;AAET,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,qBAAqB;IACnF,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IACvC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;IAC7C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE;IAC9C,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,IAAI,EAAE,EAAE,CAAC;IAC1E,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,IAAI,EAAE,EAAE,CAAC;CAC5E,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,qBAAqB;IAChE,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO;CACzD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC;IAC1C,MAAM,cAAc,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE7E,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,kGAAkG,CAAC,CAAC;IAClH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,GAAG,eAAe,CAAC,OAAO,SAAS,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,GAAG,eAAe,CAAC,OAAO,MAAM,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,GAAG,eAAe,CAAC,OAAO,mBAAmB,CAAC;AACvD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * AppFlowy MCP Server
+ * Entry point - connects MCP server to IDE via stdio transport
+ *
+ * Usage:
+ *   npx @appflowy/mcp-server
+ *   node dist/index.js
+ *
+ * Environment variables (required):
+ *   APPFLOWY_BASE_URL - Your AppFlowy Cloud URL
+ *   APPFLOWY_EMAIL + APPFLOWY_PASSWORD - OR - APPFLOWY_JWT_TOKEN
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG"}

package/dist/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * AppFlowy MCP Server
+ * Entry point - connects MCP server to IDE via stdio transport
+ *
+ * Usage:
+ *   npx @appflowy/mcp-server
+ *   node dist/index.js
+ *
+ * Environment variables (required):
+ *   APPFLOWY_BASE_URL - Your AppFlowy Cloud URL
+ *   APPFLOWY_EMAIL + APPFLOWY_PASSWORD - OR - APPFLOWY_JWT_TOKEN
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createMcpServer } from './server.js';
+import { validateConfig } from './config.js';
+async function main() {
+    try {
+        // Validate configuration
+        validateConfig();
+        // Create MCP server
+        const server = createMcpServer();
+        // Use stdio transport (standard for IDE integration)
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        // Log to stderr (stdout is reserved for MCP protocol)
+        console.error('✅ AppFlowy MCP Server started successfully');
+        console.error(`   Server: ${process.env.MCP_SERVER_NAME || 'appflowy-mcp-server'}`);
+        console.error(`   Version: ${process.env.MCP_SERVER_VERSION || '1.0.0'}`);
+        console.error(`   Connected to: ${process.env.APPFLOWY_BASE_URL}`);
+        console.error(`   Tools: workspaces, documents, databases, search, files`);
+    }
+    catch (error) {
+        console.error('❌ Failed to start AppFlowy MCP Server:', error);
+        process.exit(1);
+    }
+}
+// Graceful shutdown
+process.on('SIGINT', () => {
+    console.error('\n👋 Shutting down AppFlowy MCP Server...');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    console.error('\n👋 Shutting down AppFlowy MCP Server...');
+    process.exit(0);
+});
+// Handle uncaught errors
+process.on('uncaughtException', (error) => {
+    console.error('💥 Uncaught exception:', error);
+    process.exit(1);
+});
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,yBAAyB;QACzB,cAAc,EAAE,CAAC;QAEjB,oBAAoB;QACpB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QAEjC,qDAAqD;QACrD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,sDAAsD;QACtD,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5D,OAAO,CAAC,KAAK,CAAC,cAAc,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,qBAAqB,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,oBAAoB;AACpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,yBAAyB;AACzB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC"}

package/dist/prompts/appflowy-prompts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AppFlowy MCP Server - MCP Prompts
+ * Pre-built prompt templates for common workflows
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAppFlowyPrompts(server: McpServer): void;
+//# sourceMappingURL=appflowy-prompts.d.ts.map

package/dist/prompts/appflowy-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appflowy-prompts.d.ts","sourceRoot":"","sources":["../../src/prompts/appflowy-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAmIxD"}

package/dist/prompts/appflowy-prompts.js

@@ -0,0 +1,115 @@
+/**
+ * AppFlowy MCP Server - MCP Prompts
+ * Pre-built prompt templates for common workflows
+ */
+import { z } from 'zod';
+export function registerAppFlowyPrompts(server) {
+    // Prompt: Create technical documentation
+    server.prompt('appflowy_create_tech_doc', 'Create structured technical documentation in AppFlowy', {
+        title: z.string().describe('Document title'),
+        topic: z.string().describe('Main topic/subject'),
+        workspace_id: z.string().describe('Target workspace ID'),
+    }, ({ title, topic, workspace_id }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Create a comprehensive technical document in AppFlowy workspace ${workspace_id} with the following structure:
+
+**Title**: ${title}
+**Topic**: ${topic}
+
+Please:
+1. Create the document using appflowy_create_document
+2. Structure it with these sections:
+   - Executive Summary
+   - Scope & Objectives
+   - Architecture / Design
+   - Implementation Details
+   - Security Considerations
+   - References & Links
+
+Make it professional and ready for team collaboration.`,
+                },
+            },
+        ],
+    }));
+    // Prompt: Analyze database
+    server.prompt('appflowy_analyze_database', 'Analyze an AppFlowy database and generate insights', {
+        workspace_id: z.string().describe('Workspace ID'),
+        database_id: z.string().describe('Database/view ID'),
+    }, ({ workspace_id, database_id }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Analyze the AppFlowy database ${database_id} in workspace ${workspace_id}.
+
+Please:
+1. Read the database structure and all rows using appflowy_read_database
+2. Identify patterns, trends, and anomalies
+3. Generate a summary with key insights
+4. Suggest actionable improvements based on the data
+5. If appropriate, create a summary document with your findings`,
+                },
+            },
+        ],
+    }));
+    // Prompt: Meeting notes
+    server.prompt('appflowy_meeting_notes', 'Create structured meeting notes in AppFlowy', {
+        workspace_id: z.string().describe('Workspace ID'),
+        meeting_title: z.string().describe('Meeting title'),
+        attendees: z.string().describe('Comma-separated list of attendees'),
+    }, ({ workspace_id, meeting_title, attendees }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Create meeting notes in AppFlowy workspace ${workspace_id}.
+
+**Meeting**: ${meeting_title}
+**Attendees**: ${attendees}
+
+Please create a document with this structure:
+- Meeting Details (date, time, attendees)
+- Agenda Items
+- Discussion Points
+- Action Items (with owners and due dates)
+- Decisions Made
+- Next Steps
+
+Use appflowy_create_document to create it.`,
+                },
+            },
+        ],
+    }));
+    // Prompt: Sprint retrospective
+    server.prompt('appflowy_sprint_retro', 'Create a sprint retrospective document', {
+        workspace_id: z.string().describe('Workspace ID'),
+        sprint_number: z.string().describe('Sprint number or name'),
+    }, ({ workspace_id, sprint_number }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Create a Sprint ${sprint_number} retrospective in AppFlowy workspace ${workspace_id}.
+
+Structure:
+- Sprint Overview (dates, goals, team)
+- What Went Well 🟢
+- What Could Be Improved 🟡
+- Action Items for Next Sprint 🔴
+- Metrics & Velocity
+- Team Feedback
+
+Create it as a document and make it collaborative.`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=appflowy-prompts.js.map

package/dist/prompts/appflowy-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appflowy-prompts.js","sourceRoot":"","sources":["../../src/prompts/appflowy-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,yCAAyC;IACzC,MAAM,CAAC,MAAM,CACX,0BAA0B,EAC1B,uDAAuD,EACvD;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;KACzD,EACD,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,mEAAmE,YAAY;;aAEpF,KAAK;aACL,KAAK;;;;;;;;;;;;uDAYqC;iBAC5C;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,2BAA2B;IAC3B,MAAM,CAAC,MAAM,CACX,2BAA2B,EAC3B,oDAAoD,EACpD;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KACrD,EACD,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QAClC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iCAAiC,WAAW,iBAAiB,YAAY;;;;;;;gEAO3B;iBACrD;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,wBAAwB;IACxB,MAAM,CAAC,MAAM,CACX,wBAAwB,EACxB,6CAA6C,EAC7C;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACjD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KACpE,EACD,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,8CAA8C,YAAY;;eAE7D,aAAa;iBACX,SAAS;;;;;;;;;;2CAUiB;iBAChC;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,+BAA+B;IAC/B,MAAM,CAAC,MAAM,CACX,uBAAuB,EACvB,wCAAwC,EACxC;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACjD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KAC5D,EACD,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,mBAAmB,aAAa,wCAAwC,YAAY;;;;;;;;;;mDAUnD;iBACxC;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources/workspace-resources.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AppFlowy MCP Server - MCP Resources
+ * Exposes AppFlowy data as MCP resources
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerWorkspaceResources(server: McpServer): void;
+//# sourceMappingURL=workspace-resources.d.ts.map

package/dist/resources/workspace-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-resources.d.ts","sourceRoot":"","sources":["../../src/resources/workspace-resources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAwG3D"}