MCP JS Server Template

🚀 MCP JS 服务器模板

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

🚀 快速开始

本模板可帮助你快速搭建与Claude Desktop集成的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. 更新服务器名称和版本。

局限性

• 错误处理简单。
• 没有高级安全功能。
• 仅作为自定义实现的起点。

💻 使用示例

基础用法

在Claude中使用hello工具：

hello with name="Claude"

🔧 技术细节

本项目使用 @modelcontextprotocol/sdk 实现MCP服务器，遵循MCP协议版本2024 - 11 - 05。在开发过程中，可通过修改TOOLS数组和实现自定义工具处理程序来扩展服务器功能。同时，项目包含了简单的错误处理和日志记录机制。

🤝 贡献

欢迎大家为项目贡献力量！你可以提交拉取请求或打开问题。

📄 许可证

本项目采用MIT License。