Generate TypeScript MCP Server

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

Requirements

• Project Structure: Create a new TypeScript/Node.js project with proper directory structure

• NPM Packages: Include @modelcontextprotocol/sdk, zod@3, and either express (for HTTP) or stdio support

• TypeScript Configuration: Proper tsconfig.json with ES modules support

• Server Type: Choose between HTTP (with Streamable HTTP transport) or stdio-based server

• Tools: Create at least one useful tool with proper schema validation

• 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.