MCP Server Template 🚀

基本能力

产品定位

MCP Server Template 是一个用于快速构建 MCP 服务器的模板项目，旨在简化开发流程，提供基本的服务器结构和工具定义。

核心功能

1. 基本服务器结构：包含 MCP SDK 的基本服务器框架。
2. 示例工具定义：提供带有注释的占位符工具定义，方便开发者快速上手。
3. 错误处理：内置基本的错误处理机制，支持控制台日志记录。
4. 环境变量配置：通过 dotenv 支持环境变量配置，便于管理敏感信息（如 API 密钥）。

适用场景

1. 开发 MCP 服务器：为 AI 系统（如 Claude）提供自定义工具和数据源集成。
2. 快速原型开发：通过模板快速搭建 MCP 服务器原型，验证功能。
3. 教育与学习：作为学习 MCP 协议和服务器开发的入门项目。

使用教程

使用依赖

1. Node.js：确保已安装 Node.js（v20 或更高版本）。
2. MCP 客户端：如 Claude Desktop 或 Cursor。
3. API 密钥：如果需要包装外部服务，确保已获取相应的 API 密钥。

安装教程

1. 克隆模板仓库：

git clone https://github.com/yourusername/mcp-server-template.git
cd mcp-server-template

1. 安装依赖：

npm install

1. 构建项目：

npm run build

调试方式

1. 运行服务器：

npm run build
node build/index.js

1. 配置 MCP 客户端（如 Claude Desktop 或 Cursor）以连接到服务器。

工具列表

1. MCP SDK：提供基本的服务器框架和工具定义功能。
2. dotenv：用于管理环境变量配置。
3. Node.js：作为服务器运行的基础环境。

常见问题解答

1. 如何自定义工具？：修改 src/index.ts 文件，添加工具定义和功能实现。
2. 如何配置环境变量？：创建 .env 文件并添加所需的变量（如 API 密钥）。
3. 如何与 MCP 客户端集成？：参考文档中的配置步骤，将服务器信息添加到客户端的配置文件中。

许可证

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