MCP服务器支架
用于构建模型上下文协议(MCP)服务器的基本脚手架项目。
什么是MCP?
模型上下文协议(MCP)是一个开放协议,它规范了应用程序如何向大型语言模型(LLM)提供上下文。MCP实现了人工智能系统与各种数据源和工具之间安全、受控的交互。
特性
该脚手架提供:
- ✅ 基本MCP服务器实现
- ✅ 示例工具(echo、get_current_time)
- ✅ TypeScript支持正确的类型
- ✅ 错误处理和日志
- ✅ 符合标准MCP协议
- ✅ 开发和构建脚本
设置
- 安装依赖项:
npm install- 构建项目:
npm run build- 启动服务器:
npm start发展
对于自动重建和重启的开发:
npm run dev可用工具
回声
回应提供的信息。
参数:
message(string,必填):要回显的消息
get_current时间
以ISO格式返回当前日期和时间。
参数: 无
项目结构
mcp-server-scaffold/
├── src/
│ └── index.ts # Main server implementation
├── dist/ # Compiled JavaScript (generated)
├── package.json # Project configuration
├── tsconfig.json # TypeScript configuration
└── README.md # This file扩展服务器
要添加新工具,请执行以下操作:
- 在中添加工具定义
ListToolsRequestSchema处理器 - 在中添加工具实现
CallToolRequestSchema处理器 - 重建和测试
工具添加示例:
// In ListToolsRequestSchema handler
{
name: 'my_new_tool',
description: 'Description of what the tool does',
inputSchema: {
type: 'object',
properties: {
param1: {
type: 'string',
description: 'Description of parameter',
},
},
required: ['param1'],
},
}
// In CallToolRequestSchema handler
case 'my_new_tool':
// Your tool implementation here
return {
content: [
{
type: 'text',
text: `Result: ${args.param1}`,
},
],
};与Q CLI集成
要将此MCP服务器与Amazon Q CLI一起使用:
- 构建并确保服务器正常运行
- 在Q CLI MCP设置中配置服务器
- 这些工具将作为
mcp-server-scaffold___tool-name
错误处理
服务器包括全面的错误处理:
- 工具执行错误被捕获并作为错误响应返回
- 服务器错误记录到stderr
- SIGINT上的优雅关机
许可证
MIT许可证-您可以自由地将此脚手架用作您自己的MCP服务器的起点。
