
MCP JS Server Template

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 服务器初始化
- 提供两个基本工具:
about
和hello
- 遵循 MCP 协议版本 2024-11-05
- 使用
@modelcontextprotocol/sdk
进行服务器实现 - 包含错误处理和日志记录
适用场景
- 快速开发与 Claude Desktop 集成的自定义 MCP 服务器
- 作为学习 MCP 服务器开发的起点
- 构建简单的 MCP 服务器原型
工具列表
about
:返回 MCP 服务器的信息。hello
:提供问候语,可接受可选的名字参数。
常见问题解答
- 该模板仅提供基本功能,错误处理有限。
- 不包含高级安全特性。
- 主要用于自定义实现的起点。
使用教程
使用依赖
- Node.js (v16 或更高版本)
- Claude Desktop
@modelcontextprotocol/sdk
npm 包
安装依赖命令:
npm install @modelcontextprotocol/sdk
安装教程
- 克隆仓库
- 安装依赖:
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. 更新服务器名称和版本