MCP JS Server Template

MCP JS Server Template

site icon
2025.03.14 2
JavaScriptMCP服务器模板Claude集成开发效率
MCP JS Server Template 是一个用于创建 Model Context Protocol (MCP) 服务器的简化模板,专为与 Claude Desktop 集成而设计。它提供了开发自定义 MCP 服务器的基本结构,具有最少的样板代码。该模板实现了标准的 MCP 服务器初始化,提供了两个基本工具(`about` 和 `hello`),并遵循 MCP 协议版本 2024-11-05。
View on GitHub

Overview

基本能力

产品定位

MCP JS Server Template 是一个简化模板,用于快速创建与 Claude Desktop 集成的 MCP 服务器。

核心功能

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

适用场景

  • 快速开发与 Claude Desktop 集成的自定义 MCP 服务器
  • 作为学习 MCP 服务器开发的起点
  • 构建简单的 MCP 服务器原型

工具列表

  1. about:返回 MCP 服务器的信息。
  2. hello:提供问候语,可接受可选的名字参数。

常见问题解答

  • 该模板仅提供基本功能,错误处理有限。
  • 不包含高级安全特性。
  • 主要用于自定义实现的起点。

使用教程

使用依赖

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

安装依赖命令:

npm install @modelcontextprotocol/sdk

安装教程

  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"
      }
    }
  }
}

调试方式

在 Claude Desktop 中使用工具进行测试:

hello with name="Claude"

扩展模板

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

许可证

该项目遵循 MIT 开源许可条款。