AI Developer Tools MCP Server

Instructions

Implementation Reference

• src/tools/compare.js:67-133 (handler)

  The async execute method that implements the core logic of the compare_tools tool. It validates input, fetches metrics from mock data, computes comparisons, and formats a readable text output with insights.

  async execute(args) {
    const { tools, time_range = '30d' } = args;
  
    // Validate tool IDs
    const invalidTools = tools.filter(id => !TOOLS[id]);
    if (invalidTools.length > 0) {
      throw new Error(`Unknown tools: ${invalidTools.join(', ')}`);
    }
  
    // Build comparison data
    const comparison = tools.map(id => {
      const tool = TOOLS[id];
      const metrics = CURRENT_METRICS[id];
      const growth = getGrowthMetrics(id, time_range === '90d' ? 3 : 1);
  
      return {
        id,
        name: tool.name,
        downloads_monthly: metrics.npm_downloads_monthly,
        downloads_weekly: metrics.npm_downloads_weekly,
        github_stars: metrics.github_stars,
        stackoverflow_questions: metrics.stackoverflow_questions_30d,
        reddit_mentions: metrics.reddit_mentions_30d,
        growth_pct: growth?.growth_pct || 0,
        last_updated: metrics.last_updated
      };
    });
  
    // Format output
    let output = `📊 AI Developer Tools Comparison\n`;
    output += `📅 Time Range: ${time_range}\n\n`;
  
    // NPM Downloads section
    output += `**NPM Downloads (Monthly)**\n`;
    comparison.forEach(tool => {
      const growthIcon = tool.growth_pct > 5 ? '↑' :
                        tool.growth_pct < -5 ? '↓' : '↔';
      output += `• ${tool.name}: ${formatNumber(tool.downloads_monthly)}/month ${growthIcon} ${tool.growth_pct.toFixed(1)}%\n`;
    });
    output += '\n';
  
    // Community Activity section
    output += `**Community Activity (Last 30 Days)**\n`;
    comparison.forEach(tool => {
      output += `• ${tool.name}:\n`;
      output += `  - GitHub Stars: ${formatNumber(tool.github_stars)}\n`;
      output += `  - Stack Overflow Questions: ${tool.stackoverflow_questions}\n`;
      output += `  - Reddit Mentions: ${tool.reddit_mentions}\n`;
    });
    output += '\n';
  
    // Summary insight
    const leader = comparison.reduce((prev, curr) =>
      curr.downloads_monthly > prev.downloads_monthly ? curr : prev
    );
    const fastestGrowing = comparison.reduce((prev, curr) =>
      curr.growth_pct > prev.growth_pct ? curr : prev
    );
  
    output += `**Key Insights**\n`;
    output += `• ${leader.name} leads in adoption with ${formatNumber(leader.downloads_monthly)} monthly downloads\n`;
    output += `• ${fastestGrowing.name} shows fastest growth at ${fastestGrowing.growth_pct.toFixed(1)}% over the period\n`;
  
    output += `\n_Data updated: ${comparison[0].last_updated}_`;
  
    return output;
  }

• src/tools/compare.js:33-54 (schema)

  JSON Schema defining the input parameters for the compare_tools tool, including 'tools' array (2-3 items from enum) and optional 'time_range'.

  inputSchema: {
    type: 'object',
    properties: {
      tools: {
        type: 'array',
        items: {
          type: 'string',
          enum: ['openai', 'anthropic', 'cursor', 'copilot', 'langchain']
        },
        minItems: 2,
        maxItems: 3,
        description: 'Array of 2-3 tool IDs to compare'
      },
      time_range: {
        type: 'string',
        enum: ['7d', '30d', '90d'],
        default: '30d',
        description: 'Time range for comparison metrics'
      }
    },
    required: ['tools']
  },

• src/index.js:65-70 (registration)

  The tools array in the MCP server where compareTool is registered alongside other tools. This array is used to handle list and call requests.

  const tools = [
    compareTool,
    trendingTool,
    historyTool,
    searchTool
  ];

• src/index.js:28-32 (registration)

  Import statement that brings the compareTool into the main server file for registration.

  // Import our tool implementations
  import { compareTool } from './tools/compare.js';
  import { trendingTool } from './tools/trending.js';
  import { historyTool } from './tools/history.js';
  import { searchTool } from './tools/search.js';

• src/tools/compare.js:142-149 (helper)

  Helper function used by the handler to format large numbers (e.g., 36143000 → 36.1M) for readable output.

  function formatNumber(num) {
    if (num >= 1_000_000) {
      return `${(num / 1_000_000).toFixed(1)}M`;
    } else if (num >= 1_000) {
      return `${(num / 1_000).toFixed(0)}K`;
    }
    return num.toString();
  }