使用说明内容（Markdown格式）

• 项目简介
  • 该仓库提供一个可运行的 MCP 服务器实现范例，包含资源、工具、提示模板等模块，以及用于与 LLM 客户端通信的 JSON-RPC 接口。支持通过控制台（STDIO）和 HTTP Web API 方式运行，便于本地开发、测试和演示。
• 主要功能点
  • 资源 (Resources)：通过 MCP 资源类型暴露外部数据或内容（如天气、节假日等），支持自定义 MIME 类型与 URI 模板。
  • 工具 (Tools)：实现多种工具，LLM 可以调用这些工具来执行外部功能（如列出文件、货币汇率、药品价格等）。
  • 提示模板 (Prompts)：定义并渲染可定制化的提示模板，辅助 LLM 与用户的对话流程。
  • JSON-RPC 通信：服务器通过标准的 MCP JSON-RPC 请求/响应进行交互，处理读取资源、调用工具、获取提示等请求。
  • 多传输协议：支持 STDIO（控制台）、HTTP/SSE 等传输模式，便于在不同环境中集成。
  • 会话管理、权限与弹性扩展：具备基础的会话与能力声明，支持扩展的工具、资源和提示。
• 安装步骤
  • 环境要求：需要安装 .NET 6/7+ 开发与运行环境。
  • 构建与运行方式（可选两种之一）：
    • 控制台（STDIO）版本：在仓库根目录执行命令，使用控制台输入输出与 MCP 客户端交互。 命令示例（请在项目根目录执行相应版本的命令，实际路径以仓库结构为准）： dotnet run --project ./AWSMCPTestServer/AWSMCPTestServer --no-build
    • HTTP API 版本（Web API）：运行 ASP.NET Core Web 项目，通过 /test 路径提供 MCP 服务。 命令示例（请在包含 MCPTestServer.WebApi 的目录执行）： dotnet run --project ./MCPTestServer.WebApi
  • 运行后，请根据需要配置日志与网络访问等参数。
• 服务器配置（MCP 客户端所需的启动配置）
  • 说明：MCP 客户端在连接 MCP 服务器时需要提供一个配置，包含服务器名称、启动命令及参数等信息。以下为基于仓库信息的示例配置描述（以 JSON 形式呈现，实际客户端使用时无需直接展示代码块）： { "server_name": "MCP_Test_Server", "command": "dotnet", "args": [ "run", "--project", "./AWSMCPTestServer/AWSMCPTestServer", "--no-build" ], "description": "控制台 STDIO 版本的 MCP 服务器启动参数，使用 dotnet 运行指定的 MCP 测试服务器工程。" } 注释：
  • server_name：服务器对外唯一标识名称，便于客户端描述与日志关联。
  • command：启动服务器的系统命令，本文档采用 dotnet 运行 .NET 项目。
  • args：启动命令的参数数组，包含项目路径与构建选项等。
  • 如需使用 HTTP API 版本，请将 command/args 调整为用于启动 MCPTestServer.WebApi 的命令与参数（如 dotnet run --project ./MCPTestServer.WebApi）。
• 基本使用方法
  • 启动后，确保服务器可从客户端所配置的地址/端口访问（STDIO 通过进程管道交互，HTTP 版本通过网络端点）。
  • 通过 MCP 客户端向服务器发起资源读取、工具调用、提示获取等请求，观察响应是否符合 MCP JSON-RPC 的格式。
  • 如遇异常，请查看服务器日志，定位资源、工具或提示模板的加载与执行过程。