enfusion-mcp
使用说明(简要概览,便于快速理解与上手):
- 项目简介
- 本仓库实现了一个完整的 MCP 服务器,基于 MCP 规范提供资源、工具、Prompts 的管理与执行能力,使用 JSON-RPC 通过标准的 stdio 传输与 MCP 客户端通信。
- 服务器端还暴露了丰富的工作流工具,覆盖 Mod 创建/修改、脚本与预设件的生成功能,以及对 Workbench 的集成操作等。
- 主要功能点
- MCP 核心能力:通过 MCP 服务器框架接收请求、返回 JSON-RPC 响应,并支持通知。
- 资源与模板:提供资源注册、查询、重建、打开等能力;提供 Mod 模板、Prefab、Layout、Config 等模板生成功能。
- Tools 与 Prompts:多种工具实现数据访问、代码生成、模组创建与修改等工作流;内置 Prompts 支持交互式工作流(如 create-mod、modify-mod)。
- Workbench 集成:提供对 Arma Reforger Workbench 的连接、状态查询、脚本/资源的远程控制等能力,包含客户端状态缓存、自动启动与恢复逻辑。
- 数据与索引:包含对 Enfusion/Arma Reforger API 的本地/远程抓取、索引、搜索引擎集成,支持组件、分组、 wiki 等查询。
- 多传输与容错:当前实现以 stdio 传输为核心,设计上具备对错误的清晰错误信息返回与日志记录(通过 stderr 输出)。
- 安装与运行
- 克隆仓库并安装依赖后构建:
- npm install
- npm run build
- 启动服务器(示例,实际环境根据部署链路调整):
- 使用 Node 执行打包产物,例如 node dist/index.js
- 传输与接入
- 服务器以 stdio 传输运行,MCP 客户端通过配置的启动命令与参数连接到服务器,进行 JSON-RPC 请求与响应。
- 克隆仓库并安装依赖后构建:
- 服务器配置(供 MCP 客户端使用的启动配置)
- 服务器配置示例(JSON 格式,包含服务器名称、启动命令和参数): { "serverName": "enfusion-mcp", "command": "npx", "args": ["-y", "enfusion-mcp"] }
- 说明:该配置对应 Claude 桌面/Code 集成中常见的启动方式,使用 npx 启动 enfusion-mcp 服务。实际运行时请确保 Node 运行环境就绪,且在 README/文档中给出的路径与命令与当前部署环境吻合。
- 基本使用方法
- 通过 MCP 客户端(支持的工具/Prompts)发送 JSON-RPC 请求,查询资源、调用工具、获取 Prompts、执行工作流等。
- 服务器对请求做统一处理,返回 JSON-RPC 风格的响应或通知信息,便于 LLM 或其他客户端进行解析与后续流程控制。
- 备注
- 该实现结合了 Workbench 集成、资源模板化、广泛的模板生成能力、以及本地化/索引查询功能,定位为完整的 MCP 服务器端实现,而非仅演示或测试用例。