Typescript Mcp Server Generator
Scaffold a complete TypeScript MCP server with tools, Zod schemas, transport choice, and npm project layout for Claude or Cursor.
Overview
TypeScript MCP Server Generator is an agent skill for the Build phase that scaffolds a complete MCP server project in TypeScript with tools, resources, and configuration.
Install
npx skills add https://github.com/github/awesome-copilot --skill typescript-mcp-server-generatorWhat is this skill?
- Full TypeScript/Node scaffold with @modelcontextprotocol/sdk and zod@3 validation
- Choose HTTP Streamable transport with Express or stdio-based server
- McpServer class setup with name, version, middleware, and error handling
- Requires at least one useful tool with schema validation in the spec
- ES modules package.json, tsconfig, .gitignore, and dev runner (tsx or ts-node)
- At least one tool with schema validation required in the generator spec
Adoption & trust: 10.5k installs on skills.sh; 34.6k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want agents to call your product or data through MCP but lack a correct TypeScript server skeleton with validation and transport wiring.
Who is it for?
Indie builders adding custom MCP tools on Node/TypeScript for Claude Code, Cursor, or Codex workflows.
Skip if: Python-only MCP stacks, consuming third-party MCPs without authoring a server, or one-off shell scripts with no protocol boundary.
When should I use this skill?
Generate a complete MCP server project in TypeScript with tools, resources, and proper configuration.
What do I get? / Deliverables
You get an npm-ready MCP server with validated tools and chosen HTTP or stdio transport to register with your coding agent.
- package.json and tsconfig MCP project
- McpServer entry with tools and error handling
- .gitignore and dev scripts for local run
Recommended Skills
Journey fit
Building agent tooling is primary Build work when you expose custom capabilities to coding agents. Agent-tooling subphase fits MCP server generation—SDK wiring, tools, and stdio or HTTP transport.
How it compares
Skill-driven project generator for MCP servers—not a hosted MCP marketplace listing or a prebuilt integration pack.
Common Questions / FAQ
Who is typescript-mcp-server-generator for?
Solo builders shipping agent-powered products who need to author and maintain their own TypeScript MCP server codebase.
When should I use typescript-mcp-server-generator?
During Build when defining new agent-tooling—after you know what API or data surface agents must call but before Ship security review of exposed tools.
Is typescript-mcp-server-generator safe to install?
Generated servers may use network and filesystem; review tool scopes and the Security Audits panel on this Prism page for the skill package source.
SKILL.md
READMESKILL.md - Typescript Mcp Server Generator
# 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.