你好，世界MCP服务器

欢迎来到你好，世界MCP服务器！这个项目演示如何使用模型上下文协议（MCP） SDK搭建一个服务器。它包括工具、提示和处理服务器端事件（SSE）和消息的端点。

该项目是这篇博客文章的一部分：构建 TypeScript MCP 服务器：集成现有服务的指南。访问博客以了解项目背后的概念和实现细节。

功能

• MCP 集成：使用 MCP SDK 创建服务器，带有工具和提示。
• Express 框架：处理 HTTP 端点用于 SSE 和消息通信。
• 环境配置：使用 .env 文件进行简单配置。
• TypeScript 支持：完全带类型代码库以提高开发人员体验。

先决条件

开始之前，请确保安装了以下内容：

1. Node.js (v16 或更高) - 下载地址
2. npm（随 Node.js 提供）或 yarn

快速入门

按照以下步骤设置并运行项目：

1. 克隆仓库

如果你还没有克隆，将仓库克隆到本地机器上：

git clone https://github.com/your-username/hello-world-mcp-server.git
cd hello-world-mcp-server

2. 安装依赖项

使用 npm 或 yarn 安装所需的依赖项：

npm install

或

yarn install

3. 配置环境变量

项目使用 .env 文件来配置服务器端口。提供了一个示例的 .env.example 文件。

1. 复制 .env.example 到 .env：

   cp .env.example .env
   

2. 打开 .env 文件并更新 PORT 变量，如果需要，默认为 4000。

   PORT=4000
   

4. 构建项目

将 TypeScript 代码编译为 JavaScript：

npm run build

这将在 dist 目录下生成编译后的文件。

5. 运行服务器

以生产模式运行服务器：

npm start

或者，使用开发模式（带实时重新加载）：

npm run dev

测试服务器

1. 使用 MCP 检查器

MCP 检查器是一个测试和检查你的 MCP 服务器的工具。你可以用它来验证注册的工具和提示是否正确。

运行以下命令以检查你的服务器：

npx @modelcontextprotocol/inspector ./dist/server.js

这将打开一个交互式界面，你可以在其中测试注册在服务器中的工具和提示。

项目结构

以下是项目的概览结构：

hello-world-mcp-server/
├── src/
│   ├── server.ts                     # 主服务器文件
│   ├── index.ts                      # 入口点
│   └── routes/
│       └── exampleRoute.ts          # 示例路由
├── .env                             # 环境变量配置
├── package.json                    # 项目依赖和脚本
├── tsconfig.json                   # TypeScript 配置
└── README.md                       # 项目说明文档

贡献

欢迎贡献！随意提出问题或提交拉取请求。

许可证

该项目使用 MIT 许可证。有关详细信息，请参阅LICENSE文件。