Sun MCP Server

Instructions

Implementation Reference

• src/server.ts:80-94 (registration)

  Registration of the sun_get_summary tool in the ListToolsRequestSchema handler, defining name, description, and input schema.
  { name: 'sun_get_summary', description: 'Get content of a specific summary file', inputSchema: { type: 'object', properties: { filename: { type: 'string', description: 'Name of the summary file to retrieve', }, }, required: ['filename'], }, }, ] as Tool[],
• src/server.ts:219-249 (handler)

  Primary handler function for executing the sun_get_summary tool. It validates the filename argument, calls FileManager.getSummary to retrieve the file content, and formats the MCP response with the summary markdown or an error.
  private async handleGetSummary(args: any) { const { filename } = args; if (!filename) { throw new Error('Filename is required'); } const content = await this.fileManager.getSummary(filename); if (!content) { return { content: [ { type: 'text', text: `❌ 未找到文件: ${filename}`, }, ], }; } return { content: [ { type: 'text', text: `📄 **${filename}** ${content}`, }, ], }; }
• src/server.ts:83-92 (schema)

  Input schema definition for the sun_get_summary tool, specifying an object with a required 'filename' string property.
  inputSchema: { type: 'object', properties: { filename: { type: 'string', description: 'Name of the summary file to retrieve', }, }, required: ['filename'], },
• src/fileManager.ts:228-251 (handler)

  Core file retrieval logic invoked by the tool handler. Reads the specified .mdc summary file, parses its metadata, and returns a SavedSummaryFile object or null if not found.
  async getSummary(filename: string): Promise<SavedSummaryFile | null> { const filePath = path.join(this.sunDir, filename); try { const exists = await fs.pathExists(filePath); if (!exists) { return null; } const content = await fs.readFile(filePath, 'utf-8'); const stats = await fs.stat(filePath); const summary = this.parseSummaryFromMarkdown(content, filename); return { filename, path: filePath, summary, createdAt: stats.birthtime.toISOString() }; } catch (error) { console.error(`Failed to get summary ${filename}:`, error); return null; } }
• src/fileManager.ts:181-223 (helper)

  Helper function that parses the markdown content of a summary file to extract structured SessionSummary data, supporting both English and Chinese.
  private parseSummaryFromMarkdown(content: string, filename: string): SessionSummary { // Detect language from content const isEnglish = content.includes('Session Overview') || content.includes('Timestamp'); // Extract title (first # heading) const titleMatch = content.match(/^# (.+)$/m); const title = titleMatch ? titleMatch[1] : filename.replace('.mdc', ''); // Extract basic info (support both languages) const timestampMatch = content.match(/\*\*(Timestamp|时间戳)\*\*: (.+)$/m); const statusMatch = content.match(/\*\*(Completion Status|完成状态)\*\*: (.+)$/m); const messageCountMatch = content.match(/\*\*(Message Count|消息数量)\*\*: (\d+)$/m); // Extract essence (support both languages) const essenceMatch = content.match(/## (Core Essence|核心精髓)\n([\s\S]*?)\n\n## /) || content.match(/## (Core Essence|核心精髓)\n([\s\S]*?)$/); const essence = essenceMatch ? essenceMatch[2].trim() : ''; // Extract key points (support both languages) const keyPointsMatch = content.match(/## (Key Points|关键要点)\n([\s\S]*?)\n\n## /) || content.match(/## (Key Points|关键要点)\n([\s\S]*?)$/); const keyPoints = keyPointsMatch ? keyPointsMatch[2].split('\n').filter(line => line.startsWith('- ')).map(line => line.substring(2)) : []; // Extract outcomes (support both languages) const outcomesMatch = content.match(/## (Outcomes|完成成果)\n([\s\S]*?)(\n\n## |\n\n---)/); const outcomes = outcomesMatch ? outcomesMatch[2].split('\n').filter(line => line.startsWith('- ')).map(line => line.substring(2)) : []; return { title, essence, completionStatus: (statusMatch ? statusMatch[2] : 'unknown') as any, keyPoints, outcomes, timestamp: timestampMatch ? timestampMatch[2] : new Date().toISOString(), messageCount: messageCountMatch ? parseInt(messageCountMatch[2]) : 0, functionality: filename.split('_').slice(2).join('_').replace('.mdc', ''), language: isEnglish ? 'en' : 'zh' }; }