MCP 服务器

MCP Server Template

一个启动模板，用于构建模型上下文协议（Model Context Protocol）服务器，该服务器可以与 Cursor 或 Claude Desktop 集成，从而允许开发者为 AI 助手创建自定义工具和扩展。

AI集成系统

访问服务器

Tools

sample-tool

A sample tool for demonstration purposes

README

MCP 服务器模板 🛠️

一个用于构建您自己的模型上下文协议 (MCP) 服务器的启动模板。此模板提供了创建自定义 MCP 所需的基本结构和设置，这些 MCP 可以与 Cursor 或 Claude Desktop 一起使用。

特性

基于 TypeScript 的基本 MCP 服务器设置
示例工具实现
开箱即用的项目结构
使用 @modelcontextprotocol/sdk 构建

项目结构

mcp-server-template/
├── index.ts        # 主要服务器实现
├── package.json    # 项目依赖
├── tsconfig.json   # TypeScript 配置
└── build/         # 编译后的 JavaScript 输出

快速开始

克隆此模板：

git clone [your-repo-url] my-mcp-server
cd my-mcp-server

安装依赖：

pnpm install

构建项目：

pnpm run build

这将生成 /build/index.js 文件 - 您编译后的 MCP 服务器脚本。

与 Cursor 一起使用

转到 Cursor 设置 -> MCP -> 添加新的 MCP 服务器
配置您的 MCP：
- 名称：[选择您自己的名称]
- 类型：command
- 命令：node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js

与 Claude Desktop 一起使用

将以下 MCP 配置添加到您的 Claude Desktop 配置：

{
  "mcpServers": {
    "your-mcp-name": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"]
    }
  }
}

开发

该模板在 index.ts 中包含一个示例工具实现。要创建您自己的 MCP：

修改 index.ts 中的服务器配置：

const server = new McpServer({
  name: "your-mcp-name",
  version: "0.0.1",
});

使用 server.tool() 方法定义您的自定义工具：

server.tool(
  "your-tool-name",
  "您的工具描述",
  {
    // 使用 Zod schema 定义您的工具参数
    parameter: z.string().describe("参数描述"),
  },
  async ({ parameter }) => {
    // 在此处实现您的工具逻辑
    return {
      content: [
        {
          type: "text",
          text: "您的工具的响应",
        },
      ],
    };
  }
);