@mtcsistemas/appflowy-mcp-server 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +324 -0
  3. package/dist/config.d.ts +25 -0
  4. package/dist/config.d.ts.map +1 -0
  5. package/dist/config.js +56 -0
  6. package/dist/config.js.map +1 -0
  7. package/dist/index.d.ts +15 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +53 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/prompts/appflowy-prompts.d.ts +7 -0
  12. package/dist/prompts/appflowy-prompts.d.ts.map +1 -0
  13. package/dist/prompts/appflowy-prompts.js +115 -0
  14. package/dist/prompts/appflowy-prompts.js.map +1 -0
  15. package/dist/resources/workspace-resources.d.ts +7 -0
  16. package/dist/resources/workspace-resources.d.ts.map +1 -0
  17. package/dist/resources/workspace-resources.js +86 -0
  18. package/dist/resources/workspace-resources.js.map +1 -0
  19. package/dist/server.d.ts +7 -0
  20. package/dist/server.d.ts.map +1 -0
  21. package/dist/server.js +31 -0
  22. package/dist/server.js.map +1 -0
  23. package/dist/services/appflowy-client.d.ts +65 -0
  24. package/dist/services/appflowy-client.d.ts.map +1 -0
  25. package/dist/services/appflowy-client.js +303 -0
  26. package/dist/services/appflowy-client.js.map +1 -0
  27. package/dist/services/auth.d.ts +26 -0
  28. package/dist/services/auth.d.ts.map +1 -0
  29. package/dist/services/auth.js +89 -0
  30. package/dist/services/auth.js.map +1 -0
  31. package/dist/tools/databases.d.ts +7 -0
  32. package/dist/tools/databases.d.ts.map +1 -0
  33. package/dist/tools/databases.js +199 -0
  34. package/dist/tools/databases.js.map +1 -0
  35. package/dist/tools/documents.d.ts +7 -0
  36. package/dist/tools/documents.d.ts.map +1 -0
  37. package/dist/tools/documents.js +197 -0
  38. package/dist/tools/documents.js.map +1 -0
  39. package/dist/tools/files.d.ts +7 -0
  40. package/dist/tools/files.d.ts.map +1 -0
  41. package/dist/tools/files.js +196 -0
  42. package/dist/tools/files.js.map +1 -0
  43. package/dist/tools/search.d.ts +7 -0
  44. package/dist/tools/search.d.ts.map +1 -0
  45. package/dist/tools/search.js +60 -0
  46. package/dist/tools/search.js.map +1 -0
  47. package/dist/tools/workspaces.d.ts +7 -0
  48. package/dist/tools/workspaces.d.ts.map +1 -0
  49. package/dist/tools/workspaces.js +66 -0
  50. package/dist/tools/workspaces.js.map +1 -0
  51. package/dist/types.d.ts +140 -0
  52. package/dist/types.d.ts.map +1 -0
  53. package/dist/types.js +6 -0
  54. package/dist/types.js.map +1 -0
  55. package/package.json +64 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * AppFlowy MCP Server - Search Tools
3
+ * MCP tools for searching content
4
+ */
5
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
6
+ export declare function registerSearchTools(server: McpServer): void;
7
+ //# sourceMappingURL=search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QA+CpD"}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * AppFlowy MCP Server - Search Tools
3
+ * MCP tools for searching content
4
+ */
5
+ import { z } from 'zod';
6
+ import { appflowyClient } from '../services/appflowy-client.js';
7
+ export function registerSearchTools(server) {
8
+ // Tool: Search in workspace
9
+ server.tool('appflowy_search', `Full-text search across all content in a workspace.
10
+
11
+ Searches documents, pages, databases, and their contents.
12
+
13
+ Args:
14
+ - workspace_id: The workspace ID
15
+ - query: Search query string
16
+ - limit: Maximum results (default: 20, max: 100)`, {
17
+ workspace_id: z.string().describe('The workspace ID'),
18
+ query: z.string().min(1).describe('Search query'),
19
+ limit: z.number().int().min(1).max(100).default(20).describe('Maximum results'),
20
+ }, async ({ workspace_id, query, limit }) => {
21
+ try {
22
+ const results = await appflowyClient.search(workspace_id, query, limit);
23
+ if (results.length === 0) {
24
+ return {
25
+ content: [{ type: 'text', text: `No results found for "${query}".` }],
26
+ };
27
+ }
28
+ const lines = [`# Search Results: "${query}"\n`];
29
+ for (const result of results) {
30
+ const icon = getLayoutIcon(result.layout);
31
+ lines.push(`${icon} **${result.name}**`);
32
+ lines.push(` Type: ${result.layout} | ID: ${result.object_id}`);
33
+ if (result.score)
34
+ lines.push(` Relevance: ${(result.score * 100).toFixed(1)}%`);
35
+ lines.push('');
36
+ }
37
+ return {
38
+ content: [{ type: 'text', text: lines.join('\n') }],
39
+ };
40
+ }
41
+ catch (error) {
42
+ return {
43
+ content: [{ type: 'text', text: `❌ Search error: ${error.message}` }],
44
+ isError: true,
45
+ };
46
+ }
47
+ });
48
+ }
49
+ function getLayoutIcon(layout) {
50
+ const icons = {
51
+ Document: '📄',
52
+ Grid: '📊',
53
+ Board: '📋',
54
+ Calendar: '📅',
55
+ Gallery: '🖼️',
56
+ Chat: '💬',
57
+ };
58
+ return icons[layout] || '📄';
59
+ }
60
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,4BAA4B;IAC5B,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB;;;;;;;mDAO+C,EAC/C;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAChF,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,EAAyB,EAAE;QAC9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAExE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,KAAK,IAAI,EAAE,CAAC;iBACtE,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,sBAAsB,KAAK,KAAK,CAAC,CAAC;YACjD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,MAAM,UAAU,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBAClE,IAAI,MAAM,CAAC,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAClF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aACpD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,KAAK,GAA2B;QACpC,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,IAAI;KACX,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AAC/B,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * AppFlowy MCP Server - Workspace Tools
3
+ * MCP tools for workspace management
4
+ */
5
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
6
+ export declare function registerWorkspaceTools(server: McpServer): void;
7
+ //# sourceMappingURL=workspaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/tools/workspaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAqEvD"}
@@ -0,0 +1,66 @@
1
+ /**
2
+ * AppFlowy MCP Server - Workspace Tools
3
+ * MCP tools for workspace management
4
+ */
5
+ import { z } from 'zod';
6
+ import { appflowyClient } from '../services/appflowy-client.js';
7
+ export function registerWorkspaceTools(server) {
8
+ // Tool: List workspaces
9
+ server.tool('appflowy_list_workspaces', `List all available workspaces in your AppFlowy self-hosted instance.
10
+
11
+ Returns workspace IDs, names, creation dates, and member counts.
12
+ Use this to discover which workspace to work with.`, {}, async () => {
13
+ try {
14
+ const workspaces = await appflowyClient.listWorkspaces();
15
+ if (workspaces.length === 0) {
16
+ return {
17
+ content: [{ type: 'text', text: 'No workspaces found. Create one in the AppFlowy web app first.' }],
18
+ };
19
+ }
20
+ const lines = ['# Available Workspaces\n'];
21
+ for (const ws of workspaces) {
22
+ lines.push(`## ${ws.workspace_name || 'Unnamed Workspace'}`);
23
+ lines.push(`- **ID**: ${ws.workspace_id}`);
24
+ lines.push(`- **Created**: ${ws.created_at}`);
25
+ if (ws.member_count)
26
+ lines.push(`- **Members**: ${ws.member_count}`);
27
+ lines.push('');
28
+ }
29
+ return {
30
+ content: [{ type: 'text', text: lines.join('\n') }],
31
+ };
32
+ }
33
+ catch (error) {
34
+ return {
35
+ content: [{ type: 'text', text: `❌ Error listing workspaces: ${error.message}` }],
36
+ isError: true,
37
+ };
38
+ }
39
+ });
40
+ // Tool: Get workspace details
41
+ server.tool('appflowy_get_workspace', `Get detailed information about a specific workspace by ID.
42
+
43
+ Args:
44
+ - workspace_id: The workspace ID (get it from appflowy_list_workspaces)`, {
45
+ workspace_id: z.string().describe('The workspace ID'),
46
+ }, async ({ workspace_id }) => {
47
+ try {
48
+ const workspace = await appflowyClient.getWorkspace(workspace_id);
49
+ return {
50
+ content: [
51
+ {
52
+ type: 'text',
53
+ text: `# ${workspace.workspace_name}\n\n**ID**: ${workspace.workspace_id}\n**Created**: ${workspace.created_at}\n**Members**: ${workspace.member_count || 'N/A'}`,
54
+ },
55
+ ],
56
+ };
57
+ }
58
+ catch (error) {
59
+ return {
60
+ content: [{ type: 'text', text: `❌ Error getting workspace: ${error.message}` }],
61
+ isError: true,
62
+ };
63
+ }
64
+ });
65
+ }
66
+ //# sourceMappingURL=workspaces.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../src/tools/workspaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,wBAAwB;IACxB,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B;;;mDAG+C,EAC/C,EAAE,EACF,KAAK,IAA2B,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,cAAc,EAAE,CAAC;YAEzD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gEAAgE,EAAE,CAAC;iBACpG,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,0BAA0B,CAAC,CAAC;YAC3C,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,cAAc,IAAI,mBAAmB,EAAE,CAAC,CAAC;gBAC7D,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC9C,IAAI,EAAE,CAAC,YAAY;oBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;gBACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aACpD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB;;;0EAGsE,EACtE;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KACtD,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,EAAyB,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,KAAK,SAAS,CAAC,cAAc,eAAe,SAAS,CAAC,YAAY,kBAAkB,SAAS,CAAC,UAAU,kBAAkB,SAAS,CAAC,YAAY,IAAI,KAAK,EAAE;qBAClK;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAChF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,140 @@
1
+ /**
2
+ * AppFlowy MCP Server - Type Definitions
3
+ * Types for AppFlowy Cloud API responses and MCP server structures
4
+ */
5
+ export interface AuthToken {
6
+ access_token: string;
7
+ token_type: string;
8
+ expires_in: number;
9
+ refresh_token: string;
10
+ user: AppFlowyUser;
11
+ }
12
+ export interface AppFlowyUser {
13
+ id: string;
14
+ email: string;
15
+ name?: string;
16
+ avatar_url?: string;
17
+ role?: string;
18
+ }
19
+ export interface Workspace {
20
+ workspace_id: string;
21
+ workspace_name: string;
22
+ created_at: string;
23
+ icon?: string;
24
+ member_count?: number;
25
+ }
26
+ export interface WorkspaceMember {
27
+ name: string;
28
+ email: string;
29
+ role: string;
30
+ avatar_url?: string;
31
+ }
32
+ export type DocumentLayout = 'Document' | 'Grid' | 'Board' | 'Calendar' | 'Gallery' | 'Chat';
33
+ export interface Document {
34
+ view_id: string;
35
+ name: string;
36
+ icon?: string;
37
+ parent_view_id?: string;
38
+ layout: DocumentLayout;
39
+ created_at: string;
40
+ last_edited_time?: string;
41
+ is_favorite?: boolean;
42
+ is_locked?: boolean;
43
+ extra?: Record<string, any>;
44
+ }
45
+ export interface DocumentContent {
46
+ blocks: DocumentBlock[];
47
+ meta?: Record<string, any>;
48
+ }
49
+ export interface DocumentBlock {
50
+ id: string;
51
+ type: string;
52
+ data: Record<string, any>;
53
+ children?: DocumentBlock[];
54
+ }
55
+ export interface Database {
56
+ database_id: string;
57
+ name: string;
58
+ fields: DatabaseField[];
59
+ rows: DatabaseRow[];
60
+ views?: DatabaseView[];
61
+ }
62
+ export interface DatabaseField {
63
+ id: string;
64
+ name: string;
65
+ field_type: string;
66
+ type_options?: Record<string, any>;
67
+ is_primary?: boolean;
68
+ }
69
+ export interface DatabaseRow {
70
+ id: string;
71
+ cells: Record<string, DatabaseCell>;
72
+ created_at: string;
73
+ last_modified: string;
74
+ document_id?: string;
75
+ }
76
+ export interface DatabaseCell {
77
+ value?: any;
78
+ text?: string;
79
+ data?: any;
80
+ }
81
+ export interface DatabaseView {
82
+ view_id: string;
83
+ name: string;
84
+ layout: DocumentLayout;
85
+ filters?: any[];
86
+ sorts?: any[];
87
+ group_settings?: any[];
88
+ }
89
+ export interface SearchResult {
90
+ object_id: string;
91
+ name: string;
92
+ layout: string;
93
+ score: number;
94
+ workspace_id?: string;
95
+ }
96
+ export interface FileUploadResult {
97
+ file_id: string;
98
+ url: string;
99
+ name: string;
100
+ size: number;
101
+ mime_type: string;
102
+ created_at: string;
103
+ }
104
+ export interface FileMetadata {
105
+ file_id: string;
106
+ file_name: string;
107
+ file_size: number;
108
+ mime_type: string;
109
+ created_at: string;
110
+ modified_at?: string;
111
+ url?: string;
112
+ }
113
+ export interface BlobInfo {
114
+ workspace_id: string;
115
+ parent_dir: string;
116
+ file_id: string;
117
+ url: string;
118
+ }
119
+ export interface ToolResponse {
120
+ [key: string]: unknown;
121
+ content: Array<{
122
+ type: 'text';
123
+ text: string;
124
+ }>;
125
+ structuredContent?: Record<string, any>;
126
+ isError?: boolean;
127
+ }
128
+ export interface AppFlowyConfig {
129
+ baseUrl: string;
130
+ email: string;
131
+ password: string;
132
+ jwtToken: string;
133
+ maxFileSizeMB: number;
134
+ fileTimeoutSec: number;
135
+ }
136
+ export interface McpServerConfig {
137
+ serverName: string;
138
+ serverVersion: string;
139
+ }
140
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,6 @@
1
+ /**
2
+ * AppFlowy MCP Server - Type Definitions
3
+ * Types for AppFlowy Cloud API responses and MCP server structures
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
package/package.json ADDED
@@ -0,0 +1,64 @@
1
+ {
2
+ "name": "@mtcsistemas/appflowy-mcp-server",
3
+ "version": "1.0.0",
4
+ "description": "MCP Server for AppFlowy Self-Hosted - Connect your IDE to your AppFlowy workspace",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "bin": {
9
+ "appflowy-mcp-server": "./dist/index.js"
10
+ },
11
+ "files": [
12
+ "dist",
13
+ "README.md",
14
+ "LICENSE"
15
+ ],
16
+ "scripts": {
17
+ "build": "tsc",
18
+ "dev": "tsc --watch",
19
+ "start": "node dist/index.js",
20
+ "inspector": "npx @modelcontextprotocol/inspector dist/index.js",
21
+ "prepublishOnly": "npm run build",
22
+ "lint": "eslint src --ext .ts",
23
+ "test": "vitest run"
24
+ },
25
+ "keywords": [
26
+ "mcp",
27
+ "appflowy",
28
+ "ide",
29
+ "ai",
30
+ "workspace",
31
+ "notion-alternative",
32
+ "self-hosted",
33
+ "model-context-protocol",
34
+ "claude",
35
+ "cursor",
36
+ "vscode"
37
+ ],
38
+ "author": "AppFlowy Community",
39
+ "license": "MIT",
40
+ "repository": {
41
+ "type": "git",
42
+ "url": "https://github.com/AppFlowy-IO/appflowy-mcp-server.git"
43
+ },
44
+ "bugs": {
45
+ "url": "https://github.com/AppFlowy-IO/appflowy-mcp-server/issues"
46
+ },
47
+ "homepage": "https://github.com/AppFlowy-IO/appflowy-mcp-server#readme",
48
+ "engines": {
49
+ "node": ">=18.0.0"
50
+ },
51
+ "dependencies": {
52
+ "@modelcontextprotocol/sdk": "^1.0.4",
53
+ "axios": "^1.7.9",
54
+ "dotenv": "^16.4.7",
55
+ "form-data": "^4.0.1",
56
+ "mime-types": "^2.1.35",
57
+ "zod": "^3.24.1"
58
+ },
59
+ "devDependencies": {
60
+ "@types/mime-types": "^2.1.4",
61
+ "@types/node": "^22.10.5",
62
+ "typescript": "^5.7.3"
63
+ }
64
+ }