MCP服务器模板

一个使用TypeScript SDK创建模型上下文协议(MCP)服务器的灵活模板,支持模块化设计和本地代理集成。

  • by v4lheru
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 v4lheru/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
    
  2. 安装依赖项:

    npm install
    
  3. 构建项目:

    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 对于环境变量。

许可证

麻省理工学院