MCP JS Server 模板

概述

这是一个用于创建与 Claude Desktop 集成的 Model Context Protocol (MCP) 服务器的简化模板。它提供了一个基本结构，用于开发自定义的 MCP 服务器，并且减少了样板代码。

特性

• 实现标准的 MCP 服务器初始化
• 提供两个基本工具：about 和 hello
• 遵循 MCP 协议版本 2024-11-05
• 使用 @modelcontextprotocol/sdk 进行服务器实现
• 包含错误处理和日志记录

先决条件

• Node.js (v16 或更高版本)
• Claude Desktop
• @modelcontextprotocol/sdk npm 包

安装

1. 克隆仓库
2. 安装依赖项：

npm install @modelcontextprotocol/sdk

Claude Desktop 配置

在你的 Claude Desktop 配置文件中添加以下内容：

位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "template-server": {
      "command": "node",
      "args": [
        "/full/path/to/simplified-template-mcp-server.js"
      ],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

可用工具

1. about

返回关于 MCP 服务器的信息。

2. hello

提供问候语，可选参数为名字。

在 Claude 中的示例用法：

hello with name="Claude"

扩展模板

要创建自己的 MCP 服务器：

1. 复制此模板
2. 修改 TOOLS 数组
3. 在 server.fallbackRequestHandler 中实现自定义工具处理器
4. 更新服务器名称和版本

限制

• 错误处理简单
• 没有高级安全特性
• 作为自定义实现的起点

贡献

欢迎贡献！请提交拉取请求或打开问题。

许可证

MIT 许可证