PKS MCP 服务端（Model Context Protocol 实现）

使用说明（简明易懂，包含必要的配置与使用要点）

• 项目简介 PKS MCP 服务端是一个基于 Model Context Protocol 的后台服务组件，负责向 AI 客户端提供统一的上下文信息和功能入口。它管理项目资源、暴露可执行的工具、以及定义和渲染 Prompt 模板，允许 LLM 客户端通过 JSON-RPC 调用并获取结构化的应答。服务端支持多种传输模式（如 stdio、SSE、WebSocket），并具备会话管理、能力声明及安全性设计，方便在包括云端与本地环境的多场景部署。

• 主要功能点

  • 资源管理：集中托管项目资源，供 MCP 客户端读取和访问。
  • 工具注册与执行：将工具暴露给 MCP 客户端，支持远程调用并返回结构化结果。
  • Prompt/模板定义与渲染：提供可自定义的提示模板，用于与 LLM 的交互模式。
  • JSON-RPC 通信：通过标准的 JSON-RPC 进行请求-响应和通知，确保协议一致性。
  • 会话与能力声明：维护会话状态，声明服务能力与可用特性。
  • 多传输协议支持：支持 stdio、SSE、HTTP/WebSocket 等传输方式，满足不同部署场景。
  • 安全与可扩展性：内置错误处理、日志记录、以及对依赖注入和单元测试友好的架构。

• 安装与运行步骤

  • 克隆代码库并进入项目根目录，使用 .NET 工具链构建与运行（当前仓库包含可直接编译的 MCP 服务相关实现以及测试用例）。
  • 运行 MCP 服务通常通过 PKS CLI 提供的 mcp 子命令进行启动，示例用法请参考 README 的 MCP Server Management 章节（注：具体参数会随实现版本调整，请以实际可执行 CLI 的帮助信息为准）。

• 服务器配置（MCP 客户端所需的最小配置，JSON 格式描述） 说明：以下是面向 MCP 客户端的配置示例注释性描述，用于帮助理解服务端要暴露的核心信息。实际客户端配置不需包含代码，仅需提供 serverName、command 与参数注释即可理解如何启动与连接。

  { "serverName": "PKS-MCP-Server", // MCP 服务端的唯一名称，便于日志与监控区分 "command": "pks mcp", // 启动 MCP 服务的命令 "args": [ "--start", // 启动 MCP 服务 "--project-id", "<PROJECT_ID>", // 指定要绑定的项目标识 "--transport", "stdio|http|sse", // 传输模式（stdio、http 或 sse），可按需选择 "--port", "<port-number>" // 服务暴露的端口（如使用 http/sse，请配置端口） ], "notes": [ "不同传输模式下的端口与行为可能不同，请配合部署环境设置", "服务器会话与能力在启动后对外宣布，客户端可据此进行能力协商" ] }

• 基本使用方法

  • 启动方式：通过 PKS CLI 的 MCP 子命令（如 pks mcp --start），传输方式可选 stdio、SSE、HTTP 等，端口按需要配置。
  • 调用入口：MCP 客户端通过 JSON-RPC 向服务端发送请求，查询资源、执行工具、获取 Prompts 等。
  • 结果处理：服务器返回标准化的 JSON-RPC 响应，包含 success、data、error 等字段，客户端据此进行后续处理。
  • 运行环境：本实现具备 DI、日志、以及对多传输的支持，适用于本地开发、容器化部署和云环境运行。