ManifolderMCP
使用说明（简要概览，便于快速上手）：
-
项目简介
- ManifolderMCP 是一个 MCP 服务器实现，提供对资源、场景、对象、工具等的管理能力，并通过 MCP 协议与客户端进行 JSON-RPC 交互。服务器采用 Node.js 实现，支持通过标准 MCP 客户端调用的多种工具和资源访问方式，并可通过初始配置和 SCP 存储实现资源上传/下载等能力。
-
主要功能点
- MCP 核心能力：
- 支持通过 JSON-RPC（CallTool、ListTools、ListResources、ReadResource 等请求）与客户端通信，返回结构化的响应。
- 提供会话管理、目标解析与能力声明，统一对接 LLM 客户端。
- 支持多传输通道（示例实现为标准输入输出等 transport）。
- 资源与存储：
- 通过 SCP 存储（ScpStorage）实现资源上传、列出、下载、移动、删除等操作，支持多配置档（profiles）。
- 工具与操作：
- 提供对象、场景、资源、以及批量操作等工具集合，涵盖创建/读取/更新/删除（CRUD）等场景。
- 客户端桥接：
- 与 ManifolderClient 协同工作，内部将 MCP 客户端调用封装成 MCP 服务器可执行的操作。
- 安全与配置：
- 支持基于配置文件的 Fabric 连接、Profile 绑定、与 URL/根作用域的解析，以及对 SSL 错误的处理与告警。
- MCP 核心能力：
-
安装步骤
- 准备 Node.js 环境（推荐版本 >= 18）。
- 克隆仓库并安装依赖：
- npm install
- 构建：
- npm run build
- 运行（示例）：
- node dist/index.js
- 运行后，服务器将通过 MCP 接口对外暴露工具、资源等能力。
-
服务器配置（MCP 客户端使用说明）
- MCP 客户端启动配置示例（请以实际路径与名称替换下述占位符，以下为 JSON 格式的服务器配置信息，非客户端代码；客户端需要将该配置信息用于连接服务器）
- 服务器名称与启动参数示例（单行展示，便于粘贴理解）： { "serverName": "manifolder", "command": "node", "args": ["/absolute/path/to/ManifolderMCP/dist/index.js"] }
- 说明：
- serverName 对应客户端在命令行注册时使用的名称（如 README 中的 manifolder）。
- command 指向启动 MCP 服务器的命令（本仓库使用 Node.js）
- args 为启动命令的参数，通常包含服务器入口文件 dist/index.js 的绝对路径。
- 客户端注册的命令示例（非代码）：
- Claude Code、Codex、Gemini 等客户端可通过类似如下形式将服务器注册为一个 MCP 服务项来连接：使用服务器名称、启动命令和参数即可。此处不提供客户端代码，具体用法以各客户端帮助文档为准。
-
基本使用方法
- 启动后，MCP 客户端可以：
- 列出可用工具与资源、读取资源、创建/修改场景与对象、执行工具等操作。
- 使用多种工具进行场景浏览、对象创建/更新、资源管理等工作流。
- 常见工作流示例（在 MCP 客户端中搭建的对话/工作流）：
- 浏览 Fabric 配置、查看当前连接状态、列出场景、打开场景、创建对象、上传资源、执行批量更新等。
- 配置与数据源：
- 服务器通过 ~/.config/manifolder-mcp/config.json 加载 Fabric 连接信息与存储配置（profiles），从而实现对 Fabric 的对接与资源管理。
- 启动后，MCP 客户端可以：