Model Context Protocol (MCP) TypeScript Server Template Pack

Production MCP server with tool definitions, error boundaries, and input schemas.

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';

const server = new Server(
  { name: 'marketing-analytics-mcp', version: '1.0.0' },
  { capabilities: { tools: {} } }
);

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: 'get_campaign_performance',
      description: 'Fetches spend, conversion, and CPA metrics for a given campaign.',
      inputSchema: {
        type: 'object',
        properties: {
          campaignId: { type: 'string', description: 'Google Ads or Meta campaign ID' },
          dateRange: { type: 'string', enum: ['LAST_7_DAYS', 'LAST_30_DAYS'] },
        },
        required: ['campaignId'],
      },
    },
  ],
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === 'get_campaign_performance') {
    const campaignId = String(request.params.arguments?.campaignId);
    return {
      content: [{ type: 'text', text: JSON.stringify({ campaignId, spend: 1250.00, conversions: 42, cpa: 29.76 }) }],
    };
  }
  throw new Error('Tool not found');
});

const transport = new StdioServerTransport();
await server.connect(transport);