MCP Server TypeScript 启动器

这是一个使用 TypeScript 创建模型上下文协议 (MCP) 服务器的启动模板。它提供了一个基本设置和一个示例工具实现，以帮助您开始构建自己的 MCP 服务器。

特性

• TypeScript 配置
• 基本 MCP 服务器设置
• 示例工具实现
• 类型安全开发环境

快速开始

按照以下步骤创建您自己的 MCP 服务器：

# 为您的项目创建一个新目录
mkdir <项目名称>
cd <项目名称>

# 初始化一个新的 npm 项目
npm init -y

# 安装依赖
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript

# 创建源目录和主文件
mkdir src
touch src/index.ts

项目结构

.
├── src/
│   └── index.ts    # 主服务器实现
├── package.json    # 项目依赖和脚本
└── tsconfig.json   # TypeScript 配置

开发

1. 在 src/index.ts 中实现您的工具
2. 构建项目：

   npm run build
   

添加新工具

要添加新工具，请使用 server.tool() 方法。 示例：

server.tool(
  "工具名称",
  "工具描述",
  { 
    // 使用 Zod schema 定义您的工具参数
    param: z.string().describe("参数描述") 
  },
  async ({ param }) => {
    // 在此处实现您的工具逻辑
    return {
      content: [
        {
          type: "text",
          text: `工具已执行，参数为: ${param}`,
        },
      ],
    };
  },
);

MCP 服务器配置

您可以在项目中配置多个 MCP 服务器。 这是一个示例配置：

{
    "mcpServers": {
        "<服务器名称>": {
            "command": "<命令>",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/<项目名称>",
                "run",
                "<脚本名称>"
            ]
        }
    }
}

此配置指定：

• <服务器名称>：您的 MCP 服务器的唯一标识符
• command：运行脚本的命令（例如，python，node，uv）
• args：命令行参数数组
  • --directory：设置脚本的工作目录
  • 其他特定于您的命令和脚本需求的参数

您可以通过向 mcpServers 对象添加更多条目来配置多个服务器。

许可证

ISC