返回 MCP 目录
public公开dns本地运行

mcp-server-starter

一个即用型MCP服务器模板,提供快速搭建本地AI辅助开发环境的能力,内置多种技术文档工具和可扩展架构。

article

README

🚀 MCP 服务器启动模板

本模板可让您快速搭建自己的 MCP(模型上下文协议)服务器,还配备了文档工具和可扩展架构,使用起来十分便捷。

🚀 快速开始

参见实施指南获取分步说明,您可以在几分钟内让服务器启动并运行。

基本步骤如下:

# 1. 克隆仓库
git clone https://github.com/mgesteban/mcp-server-starter

# 2. 安装依赖项
cd mcp-server-starter
npm install

# 3. 启动服务器
npm start

✨ 主要特性

文档工具

通过 Claude 可直接访问以下文档:

  • React
  • OpenAI API
  • AWS 服务
  • TypeScript
  • Express
  • Vercel
  • Supabase

完整架构准备

  • 完整的 MCP 服务器实现
  • 工具组织的良好结构
  • 配置系统

特性优势

MCP 服务器作为您的开发助手,具备以下优势:

  • 即时文档访问:无需在多个标签页之间跳转,即可获取 React、AWS、TypeScript、Express、Vercel 和 Supabase 的文档。
  • AI 驱动的帮助:利用 AI 功能生成文档并解决开发挑战。
  • 工作流自动化:简化项目设置并跟踪开发进度。
  • 本地控制:所有内容都在您的机器上运行(端口 3000),确保隐私和速度。

📚 详细文档

此模板包含全面的文档,帮助您充分利用 MCP 服务器:

您还可以查看 .env.example 文件获取环境变量配置选项。

🔧 技术细节

什么是 MCP?

MCP 是一种通过本地服务器扩展 AI 功能的协议。此设置工具提供了一个快速入门的 MCP 服务器,其中包含常见的工具和配置。有关 MCP 的更多信息,请访问其官方文档。

这个模板是什么?

该仓库提供一个完整的、随时可用的 MCP 服务器模板,用于连接 AI 功能(如 Claude)与本地文档工具。它具有以下特点:

  • 立即使用 - 克隆、安装并运行,设置最少。
  • 易于扩展 - 可添加您自己的工具和功能。
  • 记录完整 - 有明确的定制说明。

工作原理

此模板提供一个在本地运行的 MCP 服务器。当与 VS Code 配合使用时,Claude 可以:

  1. 访问各种技术文档。
  2. 使用文档帮助解决开发任务。
  3. 根据官方文档生成代码示例和解释。

自定义服务器

此模板包括一个计算器工具示例 (src/tools/calculatorTool.js),演示了如何创建基本的 MCP 工具,带有输入验证和错误处理。

要添加您自己的工具到服务器,可按以下步骤操作:

  1. src/tools 目录中创建新工具文件。
  2. src/tools/index.js 中注册您的工具。
  3. src/config/settings.js 中更新配置。

详细说明和最佳实践可查看自定义工具指南

新手友好

如果您是新开发者,此工具可帮助您克服“文档过载”问题。无需在数十个标签页和网站之间切换,只需通过一个集成界面访问所需内容,该界面与 VS Code 集成。

🤝 贡献社区

如果您改进了此模板或添加了有用的工具,请考虑提交拉取请求,让社区受益。

📄 许可证

本项目采用 MIT 许可证,有关详细信息请查看 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端