Agentation MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • Agentation MCP 服务器是一个完整的 MCP 服务端实现，负责暴露资源、工具以及提示相关的功能给 MCP 客户端（如浏览器扩展和 OpenCode 等），通过 WebSocket 进行扩展客户端与服务器端的双向通信，并对提交的 UI 反馈进行采样处理。

• 主要功能点

  • MCP 核心能力：实现工具注册、工具调用、资源/提示等上下文数据的管理与访问。
  • WebSocket 通信：提供可扩展的 WebSocket 服务端，供扩展客户端提交反馈、查询状态与接收结果。
  • 采样与推理输出：将来自扩展的 UI 反馈经过采样流程，转发到下游 AI 模型进行分析与响应。
  • OpenCode 集成：通过 MCP 的工作流将 UI 反馈转成结构化请求，支撑 AI 辅助的设计改进。
  • 支持多传输与会话：遵循 MCP 服务器模式，具备会话管理能力和可扩展的传输支持。

• 安装步骤

  • 获取代码并构建/运行 MCP 服务器：在仓库根目录下执行构建与安装流程，确保依赖就绪后可启动 MCP 服务器。
  • 使用命令启动服务端：通过 MCP 服务器 CLI 启动脚本来运行服务器（CLI 会在 dist/cli.js 下提供可执行入口）。
  • 运行后，服务器会监听默认端口 19989，用于与 MCP 客户端建立连接。

• 服务器配置（给 MCP 客户端的配置信息，JSON 格式，包含 server、command、args 等；具体注释基于仓库信息）

  • 服务器名称（server）：agentation
  • 启动命令（command）：["node", "AGENTATION_PATH/packages/mcp-server/dist/cli.js"]
  • 参数（args）：[]
  • 说明：MCP 客户端需要知道如何启动服务器（命令及路径），以便通过该命令与服务器建立连接。服务器默认端口为 19989，如需变更可通过环境变量 AGENTATION_PORT 指定。

• 基本使用方法

  • 在扩展或客户端中配置服务器连接信息（指向上面的启动命令与端口），确保 MCP 服务器正在运行。
  • 使用扩展的 Send to AI、复制注释等功能时，扩展会通过 MCP 服务器进行采样请求，服务器端再将请求转发给 AI 模型进行处理并返回结果。
  • 如遇连接问题，请检查 MCP 服务器是否已启动、端口是否被占用，以及网络连通性。