MCP TypeScript 简单模板

用于构建模型上下文协议（MCP）服务器的一个简单的TypeScript模板。该项目提供了一个基础，用于创建可以与AI系统集成的自定义MCP工具。

概述

此模板实现了一个基本的MCP服务器，并附带一个示例BMI计算器工具。它展示了如何：

• 使用TypeScript设置MCP服务器
• 使用Zod定义和实现MCP工具及其输入验证
• 将服务器连接到标准I/O以进行通信

先决条件

• Node.js（建议版本20或更高）
• npm 或 yarn

安装

1. 克隆此仓库
2. 安装依赖：

npm install

项目结构

• index.ts - 主服务器实现文件，带示例工具
• package.json - 项目依赖和脚本
• tsconfig.json - TypeScript配置

使用方法

构建和运行

构建并启动服务器：

npm start

这将编译TypeScript代码并启动MCP服务器。

开发

在开发过程中，您可以执行以下操作：

1. 修改 index.ts 文件以添加自定义工具
2. 运行构建命令以编译：

npm run build

创建自定义工具

要创建新的工具，请按照以下模式在 index.ts 中进行操作：

server.tool(
  "your-tool-name",
  {
    // 使用Zod定义输入方案
    paramName: z.string(),
    // 添加更多参数（如果需要）
  },
  async ({ paramName }) => ({
    content: [{
      type: "text",
      text: "您的工具响应"
    }]
  })
);

依赖项

• @modelcontextprotocol/sdk - 核心MCP SDK
• zod - 方案验证
• dotenv - 环境变量管理
• typescript - TypeScript编译器

许可证

ISC

贡献

欢迎贡献！请随意提交拉取请求。