AgEnFK MCP Server

使用说明

• 项目简介
  • AgEnFK MCP Server 是一个完整的服务端实现，遵循 Model Context Protocol（MCP）的核心思想：对外暴露资源读取、工具执行和提示模板等能力，供大模型客户端以标准化的 JSON-RPC 方式调用。
  • 服务器端负责会话管理、能力声明，以及与后端 API 的桥接，确保 AI 代理在执行任务时具备一致的上下文和操作能力。
• 主要功能点
  • 资源与数据访问：提供对项目、任务、流程等资源的查询、创建、更新、删除等 API 接口。
  • 工具注册与执行：暴露 MCP 工具接口，使 LLM 能调用外部功能并获得结构化返回值。
  • Prompt/Flow 模板：支持流程与提示相关的渲染、获取与执行，帮助 LLM 按约束进行互动。
  • JSON-RPC 交互与传输：通过 MCP 的标准请求/响应格式处理调用，确保与各类客户端的互操作性。
  • 会话与能力声明：实现会话层的上下文和能力描述，支持多种传输协议（如 STDIO）。
  • 与现有后端的整合：通过 HTTP/Express 风格的后端 API 来实现“资源/工具”的实际业务逻辑。
• 安装与运行
  • 该仓库采用单体/多包的方式提供服务组件，安装与部署通常通过框架提供的安装脚本或 CLI 入口完成。常见做法是先安装依赖、构建并启动 API、再以 MCP 客户端形式连接 MCP 服务器。
  • MCP 客户端启动通常通过 CLI 提供的 mcp 子命令实现（例如 agenfk mcp），它会以 STDIO 传输启动 MCP 服务器进程，LLM 客户端通过标准输入输出与之通讯。
• 服务器配置（MCP 客户端需要提供的配置信息） 配置示例（JSON，供 MCP 客户端使用；请按实际环境替换路径与参数，不直接粘贴代码）： { "serverName": "agenfk-mcp-server", "command": "agenfk", "args": ["mcp"], "transport": "stdio", "notes": "通过 agenfk mcp 启动，服务器将通过 STDIO 与客户端进行 JSON-RPC 交互；环境变量可用于定位配置或对接 API 服务。" } 说明：
  • serverName：用于标识 MCP 服务器的名称，便于在多服务器场景中区分。
  • command / args：指定启动 MCP 服务器的命令与参数，在上述实现中，使用 agenfk mcp 启动。
  • transport：传输方式，此实现默认使用 STDIO（标准输入输出）进行客户端连接，后续也可能支持 SSE/WebSocket 等。
  • 该配置仅用于 MCP 客户端连接说明，实际运行时客户端需要根据自身框架将该配置传递给 MCP 客户端以建立连接。
• 基本使用方法
  • 启动服务：在具备依赖与构建产物的环境中执行框架提供的启动命令，或使用 agenfk up 启动 API、Kanban UI 与 MCP 服务（MCP 层作为后端服务的一部分，客户端通过配置启动）。
  • 连接方式：通过 STDIO 传输的 MCP 客户端将请求发送给 MCP 服务器；响应将以 MCP 的 JSON-RPC 规范返回。
  • 调用模式：LLM 客户端通过 MCP 调用资源读取、工具执行、以及提示渲染等能力，服务器端将请求转发到核心 API 层实现实际逻辑。
• 进阶注意
  • MCP 服务在代码中以 JSON-RPC 格式定义工具清单（ListTools）和具体工具调用（CallTool）的请求/响应模式，确保与 MCP 客户端的协议一致。
  • 安全性与会话：服务端实现了会话与能力声明，结合本地化/离线工作流的需求，确保对外暴露的能力可控。
  • 部署耦合点：MCP 服务与后端 API（packages/server）紧密耦合，调用后端 REST/HTTP 接口实现对资源的实际操作与数据持久化。