MCP Server Template

🚀 MCP 服务器模板

本模板全面覆盖了 Model Context Protocol (MCP) 服务器的构建，借助 TypeScript 和 Node.js 技术，为开发者提供了标准化的开发方案。

🚀 快速开始

# 克隆此仓库
git clone https://github.com/your-org/mcp-server-template.git my-mcp-server

# 切换到项目目录
cd my-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

# 运行示例服务器
npm start

🚀 快速开始与 LLMs 一起使用

此模板可与 AI 助手（如 Claude）无缝集成，助力 MCP 服务器开发：

1. 克隆此仓库：

   git clone https://github.com/your-org/mcp-server-template.git my-mcp-server
   cd my-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 复制 PROMPT_TEMPLATE.md 或 AI_ASSISTANT_PROMPT.md 中的提示，粘贴到与 Claude 或其他 LLM 的对话中。
4. 填写您特定的 MCP 服务器需求细节。
5. 使用 LLM 实现自定义工具、资源和其他功能。
6. 使用包含的测试工具进行测试：

   npm test
   

7. 根据需要部署您的 MCP 服务器。

✨ 主要特性

MCP 服务器实现

该模板包含基础的 MCP 服务器实现，具备以下功能：

• 协议版本协商
• 能力声明
• 工具注册和执行
• 资源管理
• 错误处理
• 日志记录

工具与资源

示例实现涵盖：

• 基本工具及其参数验证
• 使用 URI 模板的资源定义
• 提示模板

测试

模板内包含测试框架，可用于：

• 工具和资源的单元测试
• 与 MCP 客户端集成测试
• 模拟外部依赖项

📦 安装指南

# 克隆此仓库
git clone https://github.com/your-org/mcp-server-template.git my-mcp-server

# 切换到项目目录
cd my-mcp-server

# 安装依赖项
npm install

💻 使用示例

基础用法

按照以下步骤启动示例服务器：

# 克隆此仓库
git clone https://github.com/your-org/mcp-server-template.git my-mcp-server

# 切换到项目目录
cd my-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

# 运行示例服务器
npm start

高级用法

若要与 LLMs 集成开发 MCP 服务器，可参考以下步骤：

# 克隆此仓库
git clone https://github.com/your-org/mcp-server-template.git my-mcp-server
cd my-mcp-server

# 安装依赖项
npm install

# 复制提示模板并与 LLM 交互
# 填写特定需求细节，使用 LLM 实现自定义功能

# 测试项目
npm test

# 部署 MCP 服务器

📚 详细文档

在 docs/ 目录中包含详尽文档，为开发者提供全面的参考资料。

🔧 技术细节

目录结构

mcp-server-template/
├── package.json           # 配置为 ES 模块
├── tsconfig.json          # TypeScript 配置
├── README.md              # 文档与使用示例
├── PROMPT_TEMPLATE.md     # 任务特定 LLM 助手的模板
├── AI_ASSISTANT_PROMPT.md # 具有深度 MCP 专业知识的 AI 助手角色提示
├── DEVELOPMENT_RULES.md   # 开发指南
├── src/
│   ├── index.ts           # 主服务器实现
│   ├── tools/             # 示例工具实现
│   │   └── example-tool.ts
│   ├── resources/         # 示例资源实现
│   │   └── example-resource.ts
│   └── utils/             # 辅助工具
│       └── error-handling.ts
├── tests/                 # 测试脚本
│   └── server.test.js
├── docs/                  # 详细文档
│   ├── client-developers.md
│   ├── server-developers.md
│   ├── claude-users.md
│   └── mcp-reference.md
└── examples/              # 示例实现
    ├── weather-server/    # 国家气象局 API 示例
    ├── github-server/     # GitHub API 示例
    └── local-files-server/ # 本地文件系统示例

开发规则

遵循 DEVELOPMENT_RULES.md 中的指南，了解如何贡献代码。

示例

查看 examples/ 目录中的示例实现，学习如何使用 MCP 服务器模板。

贡献指南

阅读 CONTRIBUTING.md 了解如何为项目做出贡献。