@agentics.org/agentic-mcp/src/mcp/tools/summarize.ts

Agentic MCP Server with advanced AI capabilities including web search, summarization, database querying, and customer support. Built by the Agentics Foundation to enhance AI agents with powerful tools for research, content generation, and data analysis.

import { MCPTool, Context } from '../../types';
import { OpenAI } from 'openai';

export class SummarizeTool implements MCPTool {
  name = 'summarize';
  description = 'Create concise summaries of text content with key points and insights';
  inputSchema = {
    type: 'object',
    properties: {
      content: {
        type: 'string',
        description: 'The text content to summarize'
      },
      format: {
        type: 'string',
        description: 'Format of the summary',
        enum: ['bullet_points', 'narrative', 'outline'],
        default: 'bullet_points'
      },
      max_length: {
        type: 'number',
        description: 'Maximum length of summary in words',
        default: 250
      },
      include_key_quotes: {
        type: 'boolean',
        description: 'Whether to include important quotes from the original text',
        default: false
      }
    },
    required: ['content']
  };

  private openai: OpenAI;

  constructor(apiKey: string) {
    this.openai = new OpenAI({ apiKey });
  }

  async execute(params: {
    content: string;
    format?: string;
    max_length?: number;
    include_key_quotes?: boolean;
  }, context: Context): Promise<any> {
    try {
      // Track summarization start
      context.trackAction('summarization_started');
      context.remember(`summary_${Date.now()}`, {
        content_length: params.content.length,
        format: params.format || 'bullet_points'
      });

      // Construct the summarization prompt
      const prompt = this.constructSummaryPrompt(params);

      // Generate summary using GPT-4
      const response = await this.openai.chat.completions.create({
        model: 'gpt-4-turbo-preview',
        messages: [
          {
            role: 'system',
            content: 'You are an expert at creating clear, concise summaries that capture the essential information and insights from text.'
          },
          {
            role: 'user',
            content: prompt
          }
        ],
        temperature: 0.3,
        max_tokens: 1000
      });

      const summary = response.choices[0].message.content;

      // Format the summary
      const formattedSummary = this.formatSummary(summary, params);

      // Track summarization completion
      context.trackAction('summarization_completed');

      return {
        summary: formattedSummary,
        metadata: {
          original_length: params.content.length,
          summary_length: formattedSummary.length,
          format: params.format || 'bullet_points',
          timestamp: new Date().toISOString()
        }
      };
    } catch (error: unknown) {
      console.error('Summarization error:', error);
      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
      throw new Error(`Summarization failed: ${errorMessage}`);
    }
  }

  private constructSummaryPrompt(params: {
    content: string;
    format?: string;
    max_length?: number;
    include_key_quotes?: boolean;
  }): string {
    let prompt = `Please summarize the following text:\n\n${params.content}\n\n`;

    prompt += `Format the summary as ${params.format || 'bullet points'}.\n`;
    
    if (params.max_length) {
      prompt += `Keep the summary under ${params.max_length} words.\n`;
    }

    if (params.include_key_quotes) {
      prompt += `Include 2-3 important quotes from the original text.\n`;
    }

    prompt += `\nPlease include:\n`;
    prompt += `1. Main ideas and key points\n`;
    prompt += `2. Important details and supporting information\n`;
    prompt += `3. Any significant conclusions or implications\n`;

    return prompt;
  }

  private formatSummary(summary: string | null, params: {
    format?: string;
  }): string {
    if (!summary) {
      return 'No summary available.';
    }

    const header = `
Summary
Format: ${params.format || 'bullet points'}
Date: ${new Date().toISOString()}
${'-'.repeat(50)}

`;

    return header + summary;
  }
}