Power Agent MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • 该仓库包含一个基于 MCP 的服务器实现，旨在为 Copilot Studio 提供可标准化访问的资源、工具和渲染能力，便于 LLM 客户端调用外部功能、读取数据与渲染自定义界面。

• 主要功能点

  • MCP 服务器核心：实现 MCP JSON-RPC 2.0 的工具列表与工具调用接口，支持与 Copilot Studio 等客户端进行能力协商与工具执行。
  • 工具定义与执行：通过清晰的输入模式定义工具，并在服务器端执行，返回文本、卡片、以及 UI 资源等内容。
  • UI/渲染能力：支持渲染自适应卡片、网格卡片、可嵌入的沙箱小部件等，用于在客户端展示丰富的 UI。
  • 集成示例：将 Copilot Studio 客户端的对话与工具调用结果整合为统一的返回内容，便于前端呈现。

• 安装步骤

  • 需要在本地/服务器环境中安装 Node.js 与依赖。
  • 将 TypeScript 代码编译为 JavaScript（服务器实际运行需要 index.js），通常通过安装依赖并执行构建步骤来生成可执行的 mcp-server/index.js。
  • 启动方式通常通过 Node 直接运行生成的服务器文件，或将其作为子进程在桌面应用中启动（本仓库的桌面端通过 Electron 应用启动并托管该 MCP 服务器）。

• 服务器配置（适用于 MCP 客户端的连接信息，JSON 结构，示例描述性信息，实际客户端无需包含在此仓库中）

  • serverName: power-agent-desktop
  • command: node
  • args: ["mcp-server/index.js"] 说明：上述配置用于指示客户端如何启动服务器进程、以及传递给服务器的入口脚本路径。具体路径请按实际部署结构调整。

• 基本使用方法

  • 部署后，客户端（如 Copilot Studio）通过 MCP JSON-RPC 与服务器通信，执行 initialize、tools/list、tools/call 等请求，获取工具列表并调用指定工具，服务器返回文本、卡片或其他 UI 资源，供前端渲染与后续对话使用。
  • 如需自定义工具或扩展渲染能力，可修改服务器中的 TOOL 定义与渲染逻辑，并重新编译部署。