使用说明

项目简介

本项目是一个基于Node.js和TypeScript的MCP服务器示例，它实现了Model Context Protocol (MCP)，并通过Server-Sent Events (SSE) 提供实时的上下文服务。该服务器提供两个简单的计算工具：BMI计算和加法计算，用于演示MCP服务器的基本功能和与LLM客户端的集成方式。

主要功能点

SSE (Server-Sent Events) 支持: 使用SSE协议与客户端进行实时通信。
BMI 计算工具 (calculate-bmi): 根据体重和身高计算BMI指数。
加法计算工具 (calculate-sum): 计算两个数字的和。
集成示例: 提供与Github Copilot Agent 和 Microsoft Copilot Studio 集成的配置指南。
Azure App Service 部署: 支持部署到Azure云平台。

安装步骤

安装依赖: 在项目根目录下运行 'npm install' 命令安装项目依赖。
```
npm install
```
编译 TypeScript: 运行 'npm run build' 命令编译 TypeScript 代码。
```
npm run build
```
启动服务器: 运行 'npm run start' 命令启动服务器。默认情况下，服务器将在 'http://localhost:3001' 启动。
```
npm run start
```

服务器配置

对于 MCP 客户端，例如 Github Copilot Agent，您需要配置 MCP 服务器的连接信息。在 VSCode 中，打开命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)，输入 "Add MCP Server" 并选择。然后，编辑 '.vscode/mcp.json' 文件，添加以下服务器配置：

{
    "servers": {
        "my-mcp-server": {
            "type": "sse",
            "url": "http://localhost:3001/sse"
        }
    }
}

配置参数说明:

'server name': 'my-mcp-server' (服务器名称，可以自定义)
'type': '"sse"' (传输协议类型为 Server-Sent Events)
'url': '"http://localhost:3001/sse"' (MCP 服务器的 SSE 端点 URL，根据服务器实际运行地址修改)

基本使用方法

启动服务器后，MCP 客户端可以通过配置的 SSE URL 连接到该服务器。服务器提供了两个工具：

calculate-bmi: 输入体重 (weightKg) 和身高 (heightM)，返回BMI值。

示例输入:

{
  "weightKg": 70,
  "heightM": 1.75
}

示例响应:

{
  "content": [{ "type": "text", "text": "22.86" }]
}

calculate-sum: 输入两个数字 a 和 b，返回它们的和。