
Hello World MCP Server

2025.04.17
0
TypeScriptMCP 服务器SSE 支持开发效率
Hello World MCP Server 是一个基于 Model Context Protocol (MCP) SDK 的演示项目,展示了如何创建一个支持服务器发送事件 (SSE) 和消息处理的服务器。该项目集成了 MCP SDK,使用 Express 框架处理 HTTP 端点,并支持 TypeScript 开发。
View on GitHub
Overview
基本能力
产品定位
Hello World MCP Server 是一个用于演示和学习的 MCP 服务器项目,旨在帮助开发者快速上手 MCP SDK 和服务器开发。
核心功能
- MCP 集成:使用 MCP SDK 创建服务器,支持工具和提示的注册。
- Express 框架:处理 HTTP 端点,支持 SSE 和消息通信。
- 环境配置:使用
.env
文件进行配置,方便部署和管理。 - TypeScript 支持:完全类型化的代码库,提升开发体验。
适用场景
- 学习和理解 MCP SDK 的使用。
- 快速搭建一个支持 SSE 和消息处理的服务器。
- 作为其他 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