OmniFocus MCP Enhanced

Instructions

Implementation Reference

• src/server.ts:136-141 (registration)

  Registration of the 'list_custom_perspectives' tool in the MCP server, linking to schema and handler from definitions.
  server.tool( "list_custom_perspectives", "List all custom perspectives defined in OmniFocus", listCustomPerspectivesTool.schema.shape, listCustomPerspectivesTool.handler );
• src/tools/definitions/listCustomPerspectives.ts:5-7 (schema)

  Zod schema defining the input parameters for the list_custom_perspectives tool.
  export const schema = z.object({ format: z.enum(['simple', 'detailed']).optional().describe("Output format: simple (names only) or detailed (with identifiers) - default: simple") });
• src/tools/definitions/listCustomPerspectives.ts:9-31 (handler)

  MCP tool handler for list_custom_perspectives, which calls the primitive function and formats the response.
  export async function handler(args: z.infer<typeof schema>, extra: RequestHandlerExtra) { try { const result = await listCustomPerspectives({ format: args.format || 'simple' }); return { content: [{ type: "text" as const, text: result }] }; } catch (err: unknown) { const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred'; return { content: [{ type: "text" as const, text: `Error listing custom perspectives: ${errorMessage}` }], isError: true }; } }
• src/tools/primitives/listCustomPerspectives.ts:7-65 (helper)

  Helper function that executes the OmniFocus script, processes the JSON result, and formats the output based on format option.
  export async function listCustomPerspectives(options: ListCustomPerspectivesOptions = {}): Promise<string> { const { format = 'simple' } = options; try { console.log('🚀 开始执行 listCustomPerspectives 脚本...'); // Execute the list custom perspectives script const result = await executeOmniFocusScript('@listCustomPerspectives.js', {}); console.log('📋 脚本执行完成，结果类型:', typeof result); console.log('📋 脚本执行结果:', result); // 处理各种可能的返回类型 let data: any; if (typeof result === 'string') { console.log('📝 结果是字符串，尝试解析 JSON...'); try { data = JSON.parse(result); console.log('✅ JSON 解析成功:', data); } catch (parseError) { console.error('❌ JSON 解析失败:', parseError); throw new Error(`解析字符串结果失败: ${result}`); } } else if (typeof result === 'object' && result !== null) { console.log('🔄 结果是对象，直接使用...'); data = result; } else { console.error('❌ 无效的结果类型:', typeof result, result); throw new Error(`脚本执行返回了无效的结果类型: ${typeof result}, 值: ${result}`); } // 检查是否有错误 if (!data.success) { throw new Error(data.error || 'Unknown error occurred'); } // 格式化输出 if (data.count === 0) { return "📋 **自定义透视列表**\n\n暂无自定义透视。"; } if (format === 'simple') { // 简单格式：只显示名称列表 const perspectiveNames = data.perspectives.map((p: any) => p.name); return `📋 **自定义透视列表** (${data.count}个)\n\n${perspectiveNames.map((name: string, index: number) => `${index + 1}. ${name}`).join('\n')}`; } else { // 详细格式：显示名称和标识符 const perspectiveDetails = data.perspectives.map((p: any, index: number) => `${index + 1}. **${p.name}**\n 🆔 ${p.identifier}` ); return `📋 **自定义透视列表** (${data.count}个)\n\n${perspectiveDetails.join('\n\n')}`; } } catch (error) { console.error('Error in listCustomPerspectives:', error); return `❌ **错误**: ${error instanceof Error ? error.message : String(error)}`; } }
• src/utils/omnifocusScripts/listCustomPerspectives.js:1-35 (helper)

  Core OmniFocus AppleScript/JXA script that fetches all custom perspectives using Perspective.Custom.all and returns JSON.
  // 获取所有自定义透视列表 // 基于 OmniJS API: Perspective.Custom.all (() => { try { // 获取所有自定义透视 const customPerspectives = Perspective.Custom.all; // 格式化结果 const perspectives = customPerspectives.map(p => ({ name: p.name, identifier: p.identifier })); // 返回结果 const result = { success: true, count: perspectives.length, perspectives: perspectives }; return JSON.stringify(result); } catch (error) { // 错误处理 const errorResult = { success: false, error: error.message || String(error), count: 0, perspectives: [] }; return JSON.stringify(errorResult); } })();