
Hello World MCP Server

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 服务器的工具,验证工具和提示是否正确注册。
常见问题解答
- 端口已被占用:更新
.env
文件中的PORT
变量。 - TypeScript 错误:确保安装了所有依赖项并使用正确的 Node.js 版本。
使用教程
使用依赖
- Node.js (v16 或更高版本) - 下载地址
- npm 或 yarn
安装教程
- 克隆仓库:
bash git clone https://github.com/your-username/hello-world-mcp-server.git cd hello-world-mcp-server
- 安装依赖:
bash npm install
或bash yarn install
- 配置环境变量:
bash cp .env.example .env
编辑.env
文件,更新PORT
变量(默认为4000
)。 - 构建项目:
bash npm run build
- 运行服务器:
bash npm start
或开发模式:bash npm run dev
调试方式
- 使用 MCP Inspector 测试服务器:
bash npx @modelcontextprotocol/inspector ./dist/server.js
- 开发模式调试:
bash npm run dev