使用说明（Markdown格式）

• 项目简介

  • 这是一个基于 MCP（Model Context Protocol）的后端服务器实现，专门用于协同工作流中的大语言模型应用场景。该实现通过服务器端暴露工具（Tools）、资源（Resources）和提示模板（Prompts），并通过 JSON-RPC/SSE 等传输方式与客户端进行通信，支持会话管理和能力声明，便于 LLM 客户端调用外部功能、读取数据以及获取动态的提示。

• 主要功能点

  • MCP 服务端核心能力：管理和暴露 Resources、注册 Tools、定义并渲染 Prompts，提供对话/会话管理。
  • 工具注册与执行：在服务端注册多个工具（如语义搜索、按关键词搜索、天气查询、 park 信息等），供 LLM 客户端调用并接收结构化结果。
  • Prompts 与对话能力：支持系统提示、用户输入以及工具调用后的输出整合，形成最终的回应内容。
  • 传输协议与可扩展性：实现了基于 SSE 的 MCP 服务端传输方案，并具备与其他传输方式（如 Stdio、WebSocket 等）对接的示例思路。
  • 资源与向量存储示例：包含基于 Azure AI Search、Azure OpenAI、以及本地/内存向量存储的示例实现，展示如何与外部 AI 服务、向量数据库和检索能力协作。

• 安装步骤

  • 克隆或打开该项目所在目录，确保已安装 .NET SDK。
  • 进入包含 MCP SSE 服务器的项目目录（如 eShopMcpSseServer），执行构建与运行：
    • dotnet build
    • dotnet run
  • 服务器启动后，将对外暴露 /sse 等端点，客户端通过该端点建立 MCP 通信。

• 服务器配置（MCP 客户端连接配置 JSON）

  • 说明：MCP 客户端需要一个连接配置来知道如何连接 MCP 服务器。以下 JSON 示例描述服务器名称、启动命令和参数等信息，实际连接时客户端会使用服务器的地址与传输协议（如 SSE）进行通信。请将以下配置用于 MCP 客户端连接配置（JSON），其中 address 指向服务器的实际可访问地址，端口和协议以运行环境为准。
  • 示例配置（JSON）： { "server_name": "eshopmcpserver", "transport": "SSE", "command": "dotnet", "args": ["eShopMcpSseServer.dll"], "address": "http://localhost:5000/sse", "notes": "该配置用于 MCP 客户端连接到 eShopMCP SSE 服务器。实际环境中请使用实际暴露的地址与端口。" }

• 基本使用方法

  • 将 MCP 客户端配置指向该服务器（如上 JSON 示例所示）。
  • 客户端启动后，服务器会注册可用的 Tools，并通过 JSON-RPC/事件通知等方式与客户端协同工作，客户端可发起资源读取、工具调用以及提示获取等请求。
  • 在实际应用中，LLM 客户端将通过该 MCP 服务器读取资源、调用工具、获取并渲染提示，以实现对话式的上下文服务与外部功能接入。

• 备注与扩展

  • 本实现包含多种示例工具和数据源（例如语义搜索、关键词搜索、天气查询、 park 信息等），便于搭建具备多能力的 MCP 服务端。
  • 若要在生产环境使用，请结合具体云服务与容器部署方案，调整端口、证书以及身份认证等安全设置。