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.

Files1

1 files · 1.0 KB

Select a file to preview

Overall Score

82/100

Grade

B

Good

Safety

85

Quality

82

Clarity

81

Completeness

76

Summary

Generates a complete, production-ready MCP (Model Context Protocol) server in TypeScript with configurable transport (HTTP or stdio), tool/resource registration, and comprehensive error handling. The skill provides detailed guidance on project setup, server configuration, tool implementation, and testing strategies for building protocol-compliant servers.

Detected Capabilities

file writenpm package installationtypescript configurationproject scaffoldinghttp server setupstdio transport setupschema definition with zodenvironment variable reads

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

generate mcp servermcp typescript projectmcp tool integrationclaude mcp setupmodel context protocol servermcp stdio transportmcp http server

Use Cases

>Generate an HTTP-based MCP server for Claude integration
Build a stdio-based MCP server for local CLI usage
Create a data transformation tool exposed via MCP
Integrate external APIs into Claude via MCP server
Set up a file system analysis server for context provisioning
Build a database query tool server with MCP
Create a text analysis and summarization MCP endpoint

Quality Notes

Comprehensive project structure guidance with clear directory organization patterns
Detailed tool implementation examples with zod schema validation and error handling
Transport choice explained (HTTP vs stdio) with use case guidance
Excellent coverage of TypeScript best practices (type safety, async/await patterns)
Strong emphasis on configuration via environment variables rather than hardcoding
Includes testing strategy with MCP Inspector tooling and troubleshooting tips
Provides optional features (sampling, user input elicitation, dynamic registration) without requiring them
Clear separation between required and optional features
Well-structured requirements section that guides implementation priority
Resource/Prompt setup documented as optional, appropriate for different use cases
Code quality standards emphasize separation of concerns and async patterns
Guidance on proper cleanup and lifecycle management on transport close
No example code snippets — somewhat abstract, relies on developer familiarity with MCP SDK patterns

Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

typescript-mcp-server-generator