使用说明
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服务器的起点。
