使用说明
MCP学生评估服务器
此解决方案包含服务器的C+实现 模型上下文协议（MCP） 它与学生评估后端API接口。
项目结构
- McpServer ：控制台应用程序。NET实现MCP协议（stdio上的JSON-RPC）。
- FastAPI。API ASP后端API。Net Core（提供数据）。
先决条件
- .NET 8.0/9.0 SDK
- Node.js（MCP检查器需要）
安装和启动
要测试和使用MCP服务器，您需要运行两个组件：API（后端）和MCP服务器（通过检查器）。
步骤1：启动API
MCP服务器必须能够与API通信。
- 打开终端。
- 在端口上启动API 5110 :
dotnet run --project FastAPI/FastAPI.API/FastAPI.API.csproj --urls=http://localhost:5110 - Laissez是终点站。
步骤2：启动MCP检查器
检查器是客户端接口，它将“运行”MCP服务器并允许您与之交互。
- 打开一个 新 终端（最好是管理员）。
- 检查项目是否编译良好：
dotnet build McpServer/McpServer.csproj - 使用启动检查器 绝对化学 到编译的可执行文件（如有必要，更改用户路径）：
npx @modelcontextprotocol/inspector "c:\Users\richa\source\repos\MCP_TEST\McpServer\bin\Debug\net9.0\McpServer.exe" - 等待URL（例如：
http://localhost:5173）显示并在浏览器中打开。
步骤3：配置web界面
一旦进入检查员页面：
- 检查 运输类型 是的
STDIO. - 在田野里 命令，确保您有可执行文件的绝对路径：
c:\Users\richa\source\repos\MCP_TEST\McpServer\bin\Debug\net9.0\McpServer.exe - 冠军 参数 必须是 空的.
- 点击按钮
▷ Connect.
“断开连接”点必须变为绿色（“已连接”），选项卡 工具 必须出现。
可用工具
登录后，您可以测试以下工具：
-
ping_api- 检查与后端API的连接。
- 期待返回 :
{"status": "ok", "statusCode": 200, ...}
-
list_competencies- 获取API中定义的技能列表。
- 期待返回 JSON列表（例如：
[{"id": 0, "name": "SavoirEtre"}, ...]).
-
get_student- 检索学生的详细信息。
- 参数 :
studentId（学生的UUID）。 - 备注 ：如果学生不存在，API将返回错误（确认通信有效）。
配置
MCP服务器通过文件配置 McpServer/appsettings.json.
ApiBaseUrl：目标API的URL（当前配置为http://localhost:5110).
笔记技巧
- 协议 ：服务器在标准输入/输出（STDIO）上实现自定义JSON-RPC循环。
- 日志 ：日志记录从标准输出（stdout）重定向（或删除），以避免损坏JSON-RPC协议。
- 序列化 ：使用
System.Text.Json配置为忽略空值（避免严格的检查器验证错误）。
