MCP 服务器启动器
使用 TypeScript 构建模型上下文协议 (MCP) 服务器的生产就绪入门模板。
🚀 快速入门
克隆存储库
安装依赖项:
bun install
✨ 主要特点
用于快速测试和开发的 Bun
Biome 用于 linting 和格式化
使用标准版本进行自动化版本管理
干净、可维护的项目结构
📂 项目结构
mcp-starter/
├── src/
│ ├── tools/ # MCP tools implementation
│ ├── utils/ # Shared utilities
│ ├── main.ts # Server entry point
│ └── types.ts # Shared type definitions
├── tests/ # Test files
├── biome.json # Linting configuration
├── tsconfig.json # TypeScript configuration
└── package.json # Project dependencies
⚙️ 配置
创建新工具
该项目包括一个帮助创建新 MCP 工具的脚本:
bun run scripts/create-tool.ts <tool-name>
这将:
在
src/tools/<tool-name>下创建一个新的工具目录生成基本工具结构包括:
index.ts(主要实现)
schema.ts(工具参数的 JSON 架构)
test.ts(测试文件)
更新工具索引文件以导出新工具
例子:
bun run scripts/create-tool.ts weather
🛠️ 开发
运行测试:
bun test格式代码:
bun run formatLint 代码:
bun run lint构建项目:
bun run build
要将您的开发 MCP 服务器添加到 Claude Desktop:
构建项目:
bun run build添加到您的 Claude 桌面配置:
// You only need the argument if you need to pass arguments to your server { "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 桌面配置:
// You only need the argument if you need to pass arguments to your server
{
"mcpServers": {
"your-server-name": {
"command": "npx",
"args": ["-y", "your-package-name", "some_argument"]
}
}
}
Related MCP Servers
- Asecurity-licenseAqualityA production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.Last updated -14138MIT License
- Asecurity-licenseAqualityA TypeScript-based template for developing Model Context Protocol servers with features like dependency injection and service-based architecture, facilitating the creation and integration of custom data processing tools.Last updated -174
- Asecurity-licenseAqualityA TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.Last updated -1414MIT License
- -security-license-qualityA production-ready template for building Model Context Protocol servers with TypeScript, featuring Bun for fast development, Biome for linting, and an organized structure for creating MCP tools.