AI Developer Tools MCP Server

Instructions

Implementation Reference

• src/tools/history.js:41-96 (handler)

  The main handler function that executes the get_tool_history tool. It processes input arguments, retrieves historical data from mock sources, calculates growth metrics, and generates a formatted markdown report with timelines, analysis, and current stats.

  async execute(args) {
    const { tool, months = 6 } = args;
  
    // Validate tool exists
    if (!TOOLS[tool]) {
      throw new Error(`Unknown tool: ${tool}`);
    }
  
    const toolInfo = TOOLS[tool];
    const history = HISTORICAL_DATA[tool];
    const currentMetrics = CURRENT_METRICS[tool];
  
    if (!history || history.length === 0) {
      return `No historical data available for ${toolInfo.name}`;
    }
  
    // Get the requested number of months (or all available if less)
    const dataPoints = history.slice(-months);
  
    // Calculate overall growth
    const firstMonth = dataPoints[0];
    const lastMonth = dataPoints[dataPoints.length - 1];
    const totalGrowth = calculateGrowth(lastMonth.downloads, firstMonth.downloads);
  
    // Format output
    let output = `📈 ${toolInfo.name} - Historical Adoption\n\n`;
  
    output += `**${toolInfo.description}**\n`;
    output += `Package: \`${toolInfo.package}\`\n`;
    output += `Category: ${toolInfo.category}\n\n`;
  
    // Timeline
    output += `**Download History (Monthly)**\n`;
    dataPoints.forEach(point => {
      const date = new Date(point.month + '-01');
      const monthStr = date.toLocaleDateString('en-US', { year: 'numeric', month: 'short' });
      output += `• ${monthStr}: ${formatNumber(point.downloads)}\n`;
    });
    output += '\n';
  
    // Growth analysis
    output += `**Growth Analysis**\n`;
    output += `• Period: ${formatDate(firstMonth.month)} to ${formatDate(lastMonth.month)}\n`;
    output += `• Total Growth: ${totalGrowth > 0 ? '+' : ''}${totalGrowth.toFixed(1)}%\n`;
    output += `• Growth Rate: ${(totalGrowth / months).toFixed(1)}% per month\n\n`;
  
    // Current metrics
    output += `**Current Metrics**\n`;
    output += `• Monthly Downloads: ${formatNumber(currentMetrics.npm_downloads_monthly)}\n`;
    output += `• GitHub Stars: ${formatNumber(currentMetrics.github_stars)}\n`;
    output += `• Community Activity: ${currentMetrics.stackoverflow_questions_30d} SO questions, ${currentMetrics.reddit_mentions_30d} Reddit mentions (30d)\n`;
  
    output += `\n_Last updated: ${currentMetrics.last_updated}_`;
  
    return output;
  }

• src/tools/history.js:22-39 (schema)

  Input schema defining parameters for the get_tool_history tool: a required 'tool' from a predefined enum and optional 'months' (default 6).

  inputSchema: {
    type: 'object',
    properties: {
      tool: {
        type: 'string',
        enum: ['openai', 'anthropic', 'cursor', 'copilot', 'langchain'],
        description: 'Tool ID to get history for'
      },
      months: {
        type: 'integer',
        minimum: 3,
        maximum: 12,
        default: 6,
        description: 'Number of months of history to return (3-12)'
      }
    },
    required: ['tool']
  },

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

  Registration of the get_tool_history tool (as historyTool) in the central tools array used by the MCP server to handle list and call requests.

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

• src/tools/history.js:99-106 (helper)

  Helper function to format numeric values (downloads, stars) into human-readable K/M notation for the tool 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();
  }

• src/tools/history.js:108-111 (helper)

  Helper function to format month strings into readable date labels (e.g., 'Jan 2024') for the history timeline.

  function formatDate(monthStr) {
    const date = new Date(monthStr + '-01');
    return date.toLocaleDateString('en-US', { year: 'numeric', month: 'short' });
  }