MCP TypeScript Starter

Name: MCP TypeScript Starter
Author: SamMorrowDrums

@SamMorrowDrums

关于 MCP TypeScript Starter

A minimal Model Context Protocol (MCP) server in TypeScript with hello tool, markdown resource, and prompt. Includes VS Code/devcontainer setup and documentation.

#typescript #mcp #server #starter

基本信息

分类

开发工具

许可证

MIT

运行时

node

传输方式

stdio

发布者

SamMorrowDrums

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-typescript-starter": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "--",
        "npx",
        "tsx",
        "src/stdio.ts"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP TypeScript Starter?

A feature-complete Model Context Protocol (MCP) server template written in TypeScript. It demonstrates all major MCP features (tools, resources, templates, prompts) with clean, production-ready code. Intended for developers who want to build or learn MCP servers.

How to use MCP TypeScript Starter?

Clone the repository, install dependencies with npm install, and build with npm run build. Run the server using npm run start:stdio for local development or npm run start:http for remote deployment. Development mode with live reload is available via npm run dev.

Key features of MCP TypeScript Starter

Demonstrates tools with annotations, structured output, LLM sampling, progress updates, and dynamic loading
Provides static and file-based resources along with resource templates
Includes prompt templates for greetings and code review
Supports both stdio and HTTP transports
Pre-configured VS Code integration with MCP configuration and DevContainers support
Integrates with the MCP Inspector for testing and debugging

Use cases of MCP TypeScript Starter

Jump‑start a new MCP server implementation in TypeScript
Learn MCP features by studying example tools, resources, templates, and prompts
Test and debug MCP servers using the MCP Inspector
Deploy an MCP server locally via stdio or remotely over HTTP

FAQ from MCP TypeScript Starter

What are the prerequisites?

Node.js 20 or later and npm (or pnpm) are required.

How do I run the server in development mode?

Use npm run dev to start with tsx watch for instant reload on file changes.

What transports does the server support?

It supports stdio transport (npm run start:stdio) for local development and HTTP transport (npm run start:http) running on port 3000 by default.

How can I test and debug the server?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector -- npx tsx src/stdio.ts. This provides a tools, resources, prompts, and logs tab for full debugging.