🚀 MCP 服务器启动模板

本模板是一个用于构建 Model Context Protocol (MCP) 服务器的生产就绪 starter 模板，采用 TypeScript 编写，能帮助开发者高效搭建 MCP 服务器。

🚀 快速开始

克隆仓库

安装依赖

bun install

✨ 主要特性

• 借助 Bun 实现快速测试和开发，提升开发效率。
• 利用 Biome 进行代码检查和格式化，保证代码质量。
• 采用 standard - version 实现版本管理自动化，简化版本管理流程。
• 拥有清晰、易于维护的项目结构，降低开发和维护成本。

📂 项目结构

mcp-starter/
├── src/
│   ├── tools/          # MCP 工具实现
│   ├── utils/          # 公共工具类
│   ├── main.ts         # 服务器入口文件
│   └── types.ts        # 共用类型定义
├── tests/              # 测试文件
├── biome.json          # 代码检查配置
├── tsconfig.json       # TypeScript 配置
└── package.json        # 项目依赖管理

⚙️ 配置

创建新工具

该项目提供了一个脚本，可帮助你轻松创建新的 MCP 工具：

bun run scripts/create-tool.ts <tool-name>

此命令会执行以下操作：

1. 在 src/tools/<tool-name> 目录下创建一个新的工具目录。
2. 生成基本的工具结构，包含：
   • index.ts（主要实现文件）
   • schema.ts（工具参数的 JSON 模式定义）
   • test.ts（测试文件）
3. 更新工具索引文件，以便导出新的工具。

示例：

bun run scripts/create-tool.ts weather

🛠️ 开发

• 运行测试：bun test
• 格式化代码：bun run format
• 检查代码：bun run lint
• 构建项目：bun run build

若要将你的开发 MCP 服务器添加到 Claude Desktop，可按以下步骤操作：

构建项目

bun run build

更新你的 Claude Desktop 配置

// 只需要在需要传递参数时包含命令行参数
{
  "mcpServers": {
    "your-server-name": {
      "command": "node",
      "args": ["/path/to/your/project/dist/main.js", "some_argument"]
    }
  }
}

📜 版本管理

该项目使用 standard - version 实现版本管理自动化。运行 bun run release 即可创建新版本。

提交信息格式

• feat：新增功能（递增次要版本）
• fix：修复问题（递增补丁版本）
• BREAKING CHANGE：破坏性更改（递增主版本）

📦 发布到 npm

确保已登录 npm

npm login

构建项目

bun run build

发布包

npm publish

在发布新版本之前，请使用 bun run release 更新版本号。

📦 从 npm 安装（发布后）

将以下内容添加到你的 Claude Desktop 配置中：

// 只需要在需要传递参数时包含命令行参数
{
  "mcpServers": {
    "your-server-name": {
      "command": "npx",
      "args": ["-y", "your-package-name", "some_argument"]
    }
  }
}