通用MCP服务器模板
使用官方TypeScript SDK创建模型上下文协议(MCP)服务器的灵活模板。
什么是MCP?
模型上下文协议(MCP)实现了AI助手和本地运行的服务器之间的通信,这些服务器提供了额外的工具和资源。
特性
- 官方SDK:内置
@modelcontextprotocol/sdk - 类型安全:通过Zod验证完全支持TypeScript
- 标准运输:本地代理集成的标准传输
- 模块化设计:易于添加新工具和资源
入门指南
先决条件
- Node.js(v16或更高版本)
- npm或纱线
安装
- 克隆存储库:```bash
git clone https://github.com/v4lheru/generic-mcp-template.git
cd generic-mcp-server
1. 安装依赖项:```bash
npm install
- 构建项目:```bash
npm run build
### 用法
要在本地运行服务器(用于测试或开发):```bash
npm run start
注意:此服务器使用 stdio 传输,因此它希望通过标准输入/输出进行通信。它不会启动HTTP服务器。
添加到Claude桌面
- 打开Claude桌面配置(例如。
~/Library/Application Support/Claude/claude_desktop_config.json在macOS上)。 - 添加您的服务器:
json { "mcpServers": { "my-server": { "command": "node", "args": ["/path/to/generic-mcp-server/dist/index.js"] } } }
定制
- 工具:在中添加新工具
src/tools.ts. - 资源:在中添加新资源
src/resources.ts. - 配置:更新
src/config.ts对于环境变量。
许可证
麻省理工学院
