develop-mcp-server-ts

Develop MCP servers in TypeScript with the official SDK.

1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/yu-iskw/lightdash-tools --skill develop-mcp-server-ts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: develop-mcp-server-ts
Source: https://github.com/yu-iskw/lightdash-tools/tree/main/.claude/skills/develop-mcp-server-ts
Command: npx skills add https://github.com/yu-iskw/lightdash-tools --skill develop-mcp-server-ts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/sdk, zod, typescript, and includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a standardized and repeatable workflow for building Model Context Protocol (MCP) servers using TypeScript, ensuring consistency and reducing ad-hoc discovery for developers.

Core Features & Use Cases

  • Standardized Workflow: Follows a clear checklist from requirements to testing.
  • TypeScript SDK Integration: Leverages the official @modelcontextprotocol/sdk for robust server development.
  • Transport Options: Supports both Stdio (local) and Streamable HTTP (remote) transports.
  • Tool Annotations: Guides on using annotations like destructiveHint for better client-server interaction and user safety.
  • Testing Integration: Includes methods for testing with MCP Inspector and Claude Desktop.
  • Use Case: A developer needs to create a new MCP server that exposes specific tools for an AI assistant. They can follow this Skill's workflow to quickly set up the project, implement the tools with proper schemas and annotations, and test the server.

Quick Start

Follow the workflow checklist in the SKILL.md to initialize a Node/pnpm project and implement your MCP server using the TypeScript SDK.

Frequently Asked Questions about develop-mcp-server-ts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server with TypeScript?

To build an MCP server with TypeScript, you initialize a Node or pnpm project and use the official @modelcontextprotocol/sdk to implement tools, resources, and prompts following a standardized workflow.

What transports can I use for an MCP server?

MCP servers support both Stdio for local communication and Streamable HTTP for remote transports, allowing flexible client-server interaction depending on your deployment requirements.

How do I test an MCP server with Claude Desktop?

You test an MCP server by using the MCP Inspector and Claude Desktop, verifying that your implemented tools, resources, and prompts function correctly within the client environment.

What are tool annotations in MCP server development?

Tool annotations in MCP server development, such as destructiveHint, provide metadata for better client-server interaction and user safety by indicating the potential side effects of a tool.

Does the MCP TypeScript SDK support the latest protocol specification?

Yes, the MCP TypeScript SDK development workflow adheres to the MCP specification 2025-11-25, ensuring compatibility with current protocol standards for server implementation.

Do I need zod to define schemas for MCP tools?

Yes, zod is a required dependency for defining schemas, allowing you to validate inputs and implement tools with proper annotations in your TypeScript MCP server.