简体中文 | English
《原神·千星奇域》节点图模拟器MCP服务器
此仓库为AI代理提供可以创建和管理WebMiliastra节点图和项目的MCP服务器。目前提供了节点图/项目工具，将在后续完成参考文档
[!WARNING]
该项目90%以上代码均由AI生成。
此服务器提供的功能
- 节点图工具： 列出、读取、写入和验证
GraphDocumentJson文件 - 项目工具： 读取/写入包含
manifest.json和节点图文件的文件夹 - 节点索引： 一个小型的节点定义样本文件，以及用于完整数据的覆盖路径
- 通过MCP资源（
nodegraph://docs/...）公开的文档资源
仓库目录
graphs/- 节点图Json文件（节点图工具的默认目标）projects/- 项目文件夹（每个文件夹包含manifest.json和节点图文件）docs/- 作为MCP资源提供的参考文档data/- 节点定义数据（将在后续根据 data.ts 完善数据）
安装与运行
git clone https://github.com/Columbina-Dev/WebMiliastraNodesEditor-MCPServer.git
cd WebMiliastraNodesEditor-MCPServer/
npm install
npm run build
node build/index.js
环境变量
NODEGRAPH_WORKSPACE: 文档和数据的基础工作区（默认：当前工作目录）NODEGRAPH_GRAPHS_DIR: 节点图存储文件夹（默认：<workspace>/graphs）NODEGRAPH_PROJECTS_DIR: 项目存储文件夹（默认：<workspace>/projects）NODEGRAPH_NODE_DEFS_PATH: Json节点定义数据的路径
P.S.: data/nodeDefinitions.sample.json 为临时测试数据集，后续需将数据替换为完整的节点定义数据以保证准确性
MCP 配置示例
OpenAI Codex
注意事项
- 需根据官方编辑器教程HTML导入更多的参考文档，见
docs/tutorial-plan.md - 目前为临时测试MCP服务器，几乎无法生成正常可用的节点图和项目文件，需在后续完善文档和节点定义数据以验证格式
- 与 主项目 相同，此MCP服务器项目同样采用GPLv3许可证。