使用 NestJS MCP 服务器 - 模型上下文协议示例

作者：@LiusDev

此仓库演示了 NestJS 实现的模型上下文协议（MCP）和微服务架构。它包含两个主要服务：

1. mcp-server：提供获取当前时间上下文的功能，供大型语言模型（LLMs）使用
2. mcp-backend：一个客户端，使用 LangChain.js 并集成了 MCP 客户端 SDK 以连接到 MCP 服务器

入门指南

先决条件

• Node.js (v20 或更高版本)
• npm

安装

1. 克隆仓库
2. 安装依赖：

npm install

3. 复制 .env.example 到 .env 并添加你的 OpenAI API 密钥：

cp .env.example .env

然后编辑 .env 文件以包含你的 OpenAI API 密钥：

OPENAI_API_KEY=your_openai_api_key_here
OPENAI_API_URL=https://api.openai.com/v1
PORT=3001

运行服务

你需要同时运行两个服务才能实现完整的功能：

启动 MCP 服务器

npm run start:dev mcp-server

这将启动 MCP 服务器，端口为 3000（默认）。

启动 MCP 后台

npm run start:dev mcp-backend

这将启动 MCP 后台，端口为 3001（默认）。

使用示例

一旦两个服务都在运行，你可以通过发送 POST 请求来测试功能：

样例请求

向 http://localhost:3001 发送 POST 请求，并包含以下 JSON 正文：

{
  "message": "What time is it in Viet Nam?"
}

使用 curl

curl -X POST http://localhost:3001 -H "Content-Type: application/json" -d '{"message":"What time is it in Viet Nam?"}'

使用 Postman

1. 打开 Postman，创建一个新的请求。
2. 设置 URL 为 http://localhost:3001。
3. 选择 POST 方法。
4. 在请求头中添加 Content-Type: application/json。
5. 在请求体中输入以下 JSON：

   {
     "message": "What time is it in Viet Nam?"
   }
   

6. 发送请求，查看响应。

## 连接到多个 MCP 服务器

要在 `mcp-backend` 中连接到多个 MCP 服务器，请在 `src/main.ts` 文件中进行以下配置：

```typescript
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  // 添加其他 MCP 服务器的主机和端口
  const otherMcpServers = ['http://localhost:3002', 'http://localhost:3003'];
  
  // 注册 MCP 服务提供程序（可选）
  // app.registerMcpProvider(otherMcpServers);

  await app.listen(3001);
}

架构

• mcp-server：负责处理和返回与时间相关的请求。
• mcp-backend：作为客户端，用于向 MCP 服务器发送请求并接收响应。

所用技术

• NestJS：用于构建微服务架构。
• LangChain.js：用于与大型语言模型交互。
• Axios：用于 HTTP 请求处理。

项目结构

^_^

许可证

此项目根据 UNLICENSED 许可证分发，有关详细信息，请参阅 LICENSE 文件。