MCP TypeScript Simple Template

MCP TypeScript简单模板

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

概述

此模板使用示例BMI计算器工具实现了一个基本的MCP服务器。它演示了如何：

• 在TypeScript中设置MCP服务器
• 使用Zod定义和实施具有输入验证的MCP工具
• 将服务器连接到标准I/O进行通信

先决条件

• Node.js（建议使用v20或更高版本）
• npm或纱线

安装

1. 克隆此存储库
2. 安装依赖项：

npm install

项目结构

• index.ts -使用示例工具实现主服务器
• package.json -项目依赖关系和脚本
• tsconfig.json -TypeScript配置

用法

建立和运行

构建并启动服务器：

npm start

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

发展

对于开发，您可以：

1. 修改 index.ts 添加自己的工具
2. 运行build命令进行编译：

npm run build

创建自定义工具

要创建新工具，请按照以下模式操作 index.ts:

server.tool(
  "your-tool-name",
  {
    // Define input schema using Zod
    paramName: z.string(),
    // Add more parameters as needed
  },
  async ({ paramName }) => ({
    content: [{
      type: "text",
      text: "Your tool's response"
    }]
  })
);

依赖项

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

许可证

国际协调委员会

贡献

欢迎投稿！请随时提交拉取请求。