MCP Server TypeScript Template

MCP 服务 TypeScript 模板

使用 TypeScript 创建 Model Context Protocol（MCP）服务的模板。本项目演示如何实现一个包含自定义工具的简单 MCP 服务。

概述

此模板实现了一个基础 MCP 服务，提供以下工具：

• 示例操作：简单的演示操作
• 加法：将两个数字相加的工具

该服务使用 Model Context Protocol SDK 处理 AI 模型与外部工具之间的通信。

前提条件

• Node.js（v16 或更高版本）
• npm 或 yarn

项目结构

项目结构如下：

mcp-server-typescript-template/
├── common/
│   ├── constant.ts     # Project constants
│   ├── errors.ts       # Error handling utilities
│   └── types.ts        # Type definitions
│   └── utils.ts        # Utility functions

├── operations/
│   └── example-operation.ts  # Implementation of example operations
├── index.ts            # Main server implementation
├── package.json
└── tsconfig.json

安装

克隆仓库并安装依赖：

git clone <repository-url>
cd mcp-server-typescript-template
npm install
npm run test
npm run build
npm run start # this will start the server for testing

配置 MCP 客户端（Claude Desktop）

编辑 claude_desktop_config.json 文件，并添加以下内容：

{
  "mcpServers": {
    "example": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-typescript-template/dist/index.js"
      ]
    }
  }
}