Hello World MCP Server

Hello World MCP Server

site icon
2025.05.09 0
TypeScriptMCP 集成服务器构建开发工具开发效率
Hello World MCP Server 是一个基于 Model Context Protocol (MCP) SDK 的示例服务器项目,用于展示如何通过 MCP 集成现有服务。该项目提供了工具、提示和端点,用于处理服务器发送事件 (SSE) 和消息通信。
View on GitHub

Overview

基本能力

产品定位

Hello World MCP Server 是一个演示项目,旨在帮助开发者理解如何使用 MCP SDK 构建服务器,并集成现有服务。

核心功能

  • MCP 集成:使用 MCP SDK 创建服务器,支持工具和提示的注册。
  • Express 框架:处理 HTTP 端点,支持 SSE 和消息通信。
  • 环境配置:通过 .env 文件轻松配置服务器。
  • TypeScript 支持:完全类型化的代码库,提升开发体验。

适用场景

  • 开发者学习 MCP 服务器构建。
  • 快速集成现有服务到 MCP 生态。
  • 测试和调试 MCP 工具和提示。

工具列表

  • MCP Inspector:用于测试和检查 MCP 服务器的工具,验证工具和提示是否正确注册。

常见问题解答

  1. 端口已被占用:更新 .env 文件中的 PORT 变量。
  2. TypeScript 错误:确保安装了所有依赖项并使用正确的 Node.js 版本。

使用教程

使用依赖

  1. Node.js (v16 或更高版本) - 下载地址
  2. npmyarn

安装教程

  1. 克隆仓库: bash git clone https://github.com/your-username/hello-world-mcp-server.git cd hello-world-mcp-server
  2. 安装依赖: bash npm installbash yarn install
  3. 配置环境变量: bash cp .env.example .env 编辑 .env 文件,更新 PORT 变量(默认为 4000)。
  4. 构建项目: bash npm run build
  5. 运行服务器: bash npm start 或开发模式: bash npm run dev

调试方式

  1. 使用 MCP Inspector 测试服务器: bash npx @modelcontextprotocol/inspector ./dist/server.js
  2. 开发模式调试: bash npm run dev

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。