Generic MCP Template

通用MCP服务器模板

使用官方TypeScript SDK创建模型上下文协议（MCP）服务器的灵活模板。

什么是MCP？

模型上下文协议（MCP）实现了AI助手和本地运行的服务器之间的通信，这些服务器提供了额外的工具和资源。

特性

• 官方SDK：内置 @modelcontextprotocol/sdk
• 类型安全：通过Zod验证完全支持TypeScript
• 标准运输：本地代理集成的标准传输
• 模块化设计：易于添加新工具和资源

入门指南

先决条件

• Node.js（v16或更高版本）
• npm或纱线

安装

1. 克隆存储库：

   git clone https://github.com/v4lheru/generic-mcp-template.git
   cd generic-mcp-server

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

用法

要在本地运行服务器（用于测试或开发）：

npm run start

注意：此服务器使用 stdio 传输，因此它希望通过标准输入/输出进行通信。它不会启动HTTP服务器。

添加到Claude桌面

1. 打开Claude桌面配置（例如。 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）。
2. 添加您的服务器：

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/generic-mcp-server/dist/index.js"]
    }
  }
}

定制

• 工具：在中添加新工具 src/tools.ts.
• 资源：在中添加新资源 src/resources.ts.
• 配置：更新 src/config.ts 对于环境变量。

许可证

麻省理工学院