mcp服务器启动器
使用单个命令构建一个可运行的模型上下文协议(MCP)服务器
](https://www.npmjs.com/package/mcp-server-starter) 
✨ 特性
- 🚀 即时设置 -在几秒钟内生成一个完整的MCP服务器
- 🛠️ 易于工具管理 -添加具有自动注册表更新功能的新工具
- 📦 TypeScript就绪 -具有严格TypeScript配置的完全类型安全
- ✅ 生产就绪 -遵循MCP规范,与Claude Desktop配合使用
- 🔧 零配置 -合理的默认设置,只需开始编写工具代码
- 🎯 开发者友好 -交互式提示,清除错误消息
🎬 快速开始
创建新的MCP服务器
npx mcp-server-starter init --name my-awesome-server
cd my-awesome-server
npm install
npm run build
npm start就是这样!现在,您有一个可用的MCP服务器,其中包含一个示例回显工具。
📚 用法
初始化新服务器
# Interactive mode
npx mcp-server-starter init
# With options
npx mcp-server-starter init --name my-server --preset minimal
# With description
npx mcp-server-starter init --name my-server --description "My custom MCP server"将工具添加到服务器
# Navigate to your server directory
cd my-server
# Add a new tool (interactive)
npx mcp-server-starter add-tool
# Add with options
npx mcp-server-starter add-tool --name calculator --title "Calculator" --description "Performs calculations"
# Force overwrite existing tool
npx mcp-server-starter add-tool --name calculator --force生成了什么?
my-server/
├── package.json # MCP SDK dependencies included
├── tsconfig.json # Strict TypeScript config
├── README.md # Complete documentation
├── .gitignore # Sensible defaults
└── src/
├── server.ts # MCP server entry point
└── mcp/
└── tools/
├── index.ts # Tool registry (auto-updated!)
└── echo.ts # Sample tool🔌 连接到克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"my-server": {
"command": "node",
"args": ["/absolute/path/to/my-server/dist/server.js"]
}
}
}重新启动Claude Desktop,您的工具将可用!
🛠️ 工具开发
示例:计算器工具
// src/mcp/tools/calculator.ts
import { z } from 'zod';
import type { Tool } from './index.js';
const calculatorInputSchema = z.object({
operation: z.enum(['add', 'subtract', 'multiply', 'divide']),
a: z.number(),
b: z.number(),
});
export const calculatorTool: Tool = {
name: 'calculator',
description: 'Performs basic math operations',
inputSchema: {
type: 'object',
properties: {
operation: {
type: 'string',
enum: ['add', 'subtract', 'multiply', 'divide'],
},
a: { type: 'number' },
b: { type: 'number' },
},
required: ['operation', 'a', 'b'],
},
handler: async (args: unknown) => {
const input = calculatorInputSchema.parse(args);
let result: number;
switch (input.operation) {
case 'add':
result = input.a + input.b;
break;
case 'subtract':
result = input.a - input.b;
break;
case 'multiply':
result = input.a * input.b;
break;
case 'divide':
result = input.a / input.b;
break;
}
return {
content: [
{
type: 'text',
text: `Result: ${result}`,
},
],
};
},
};将其添加到您的服务器:
npx mcp-server-starter add-tool --name calculator
# Edit src/mcp/tools/calculator.ts with the code above
npm run build
npm start该工具已自动注册,无需手动导入!
📖 CLI命令
init
初始化新的MCP服务器项目。
选项:
--name, -n-项目名称(需要烤肉串)--description, -d-项目描述--preset, -p-模板预设(minimal或examples)--with-http-adapter-包括HTTP传输适配器
示例:
npx mcp-server-starter init --name my-server
npx mcp-server-starter init --name my-server --preset minimal
npx mcp-server-starter init --name my-server --with-http-adapteradd-tool
向现有MCP服务器添加新工具。
选项:
--name, -n-工具名称(camelCase必填)--title, -t-工具显示标题--description, -d-工具说明--force, -f-如果工具存在,则覆盖
示例:
npx mcp-server-starter add-tool --name myTool
npx mcp-server-starter add-tool --name calculator --title "Calculator"
npx mcp-server-starter add-tool --name calculator --force🎯 用例
为以下对象构建MCP服务器:
- 🌤️ 天气API -获取当前天气和预报
- 🗄️ 数据库操作 -查询、插入、更新数据
- 📁 文件系统 -读取、写入、搜索文件
- 🧮 计算 -数学、转换、计算
- 🌐 Web剪贴 -获取和解析web内容
- 📧 电子邮件 -发送通知和消息
- 🔍 搜索引擎 -自定义搜索工具
- 🤖 自定义API -集成任何REST API
🧪 测试您的服务器
生成的服务器使用:
- ✅ 克劳德桌面 -原生MCP支持
- ✅ 自定义MCP客户端 -使用
@modelcontextprotocol/sdk - ✅ OpenAI函数调用 -通过自定义集成
- ✅ 任何JSON-RPC客户端 -标准标准传输
📋 需求
- Node.js>=18.0.0
- npm或纱线
🤝 贡献
欢迎投稿!请随时提交拉取请求。
📄 许可证
麻省 理工© 圣诞1111
🔗 链接
🙏 致谢
内置:
______________________________________________________________________
由以下材料制成❤️ 对于MCP社区
