MCP Server Typescript Template

🚀 MCP 服务器 TypeScript 模板

本模板可用于创建模型上下文协议（MCP）服务器。它展示了如何实现一个简单的 MCP 服务器，还带有自定义工具，能助力开发者快速搭建相关项目。

🚀 快速开始

先决条件

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

安装步骤

克隆仓库并安装依赖项：

git clone <repository-url>
cd mcp-server-typescript-template
npm install
npm run test
npm run build
npm run start # 这将启动测试服务器

配置 MCP 客户端（Claude Desktop）

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

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

✨ 主要特性

该模板实现了一个基本的 MCP 服务器，提供以下工具：

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

服务器使用模型上下文协议 SDK 处理 AI 模型与外部工具之间的通信。

📚 详细文档

项目结构

项目的结构如下：

mcp-server-typescript-template/
├── common/
│   ├── constant.ts     # 项目常量
│   ├── errors.ts       # 错误处理工具
│   └── types.ts        # 类型定义
│   └── utils.ts        # 工具函数
├── operations/
│   └── example-operation.ts  # 示例操作的实现
├── index.ts            # 主服务器实现
├── package.json
└── tsconfig.json