Generate TypeScript MCP Server

Create a complete Model Context Protocol (MCP) server in TypeScript with the following specifications:

Requirements

1. Project Structure: Create a new TypeScript/Node.js project with proper directory structure
2. NPM Packages: Include @modelcontextprotocol/sdk, zod@3, and either express (for HTTP) or stdio support
3. TypeScript Configuration: Proper tsconfig.json with ES modules support
4. Server Type: Choose between HTTP (with Streamable HTTP transport) or stdio-based server
5. Tools: Create at least one useful tool with proper schema validation
6. Error Handling: Include comprehensive error handling and validation

Implementation Details

Project Setup

• Initialize with

  npm init

  and create package.json
• Install dependencies:

  @modelcontextprotocol/sdk

  ,

  zod@3

  , and transport-specific packages
• Configure TypeScript with ES modules:

  "type": "module"

  in package.json
• Add dev dependencies:

  tsx

  or

  ts-node

  for development
• Create proper .gitignore file

Server Configuration

• Use

  McpServer

  class for high-level implementation
• Set server name and version
• Choose appropriate transport (StreamableHTTPServerTransport or StdioServerTransport)
• For HTTP: set up Express with proper middleware and error handling
• For stdio: use StdioServerTransport directly

Tool Implementation

• Use

  registerTool()

  method with descriptive names
• Define schemas using zod for input and output validation
• Provide clear

  title

  and

  description

  fields
• Return both

  content

  and

  structuredContent

  in results
• Implement proper error handling with try-catch blocks
• Support async operations where appropriate

Resource/Prompt Setup (Optional)

• Add resources using

  registerResource()

  with ResourceTemplate for dynamic URIs
• Add prompts using

  registerPrompt()

  with argument schemas
• Consider adding completion support for better UX

Code Quality

• Use TypeScript for type safety
• Follow async/await patterns consistently
• Implement proper cleanup on transport close events
• Use environment variables for configuration
• Add inline comments for complex logic
• Structure code with clear separation of concerns

Example Tool Types to Consider

• Data processing and transformation
• External API integrations
• File system operations (read, search, analyze)
• Database queries
• Text analysis or summarization (with sampling)
• System information retrieval

Configuration Options

• For HTTP Servers:

  • Port configuration via environment variables
  • CORS setup for browser clients
  • Session management (stateless vs stateful)
  • DNS rebinding protection for local servers

• For stdio Servers:

  • Proper stdin/stdout handling
  • Environment-based configuration
  • Process lifecycle management

Testing Guidance

• Explain how to run the server (

  npm start

  or

  npx tsx server.ts

  )
• Provide MCP Inspector command:

  npx @modelcontextprotocol/inspector

• For HTTP servers, include connection URL:

  http://localhost:PORT/mcp

• Include example tool invocations
• Add troubleshooting tips for common issues

Additional Features to Consider

• Sampling support for LLM-powered tools
• User input elicitation for interactive workflows
• Dynamic tool registration with enable/disable capabilities
• Notification debouncing for bulk updates
• Resource links for efficient data references

Generate a complete, production-ready MCP server with comprehensive documentation, type safety, and error handling.