Webmiliastranodeseditor Mcpserver

🚀 《原神·千星奇域》節點圖模擬器MCP服務器

此倉庫為AI代理提供可創建和管理WebMiliastra節點圖與項目的MCP服務器。當前已提供節點圖/項目工具，後續會完成參考文檔。

🚀 快速開始

安裝與運行

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 為臨時測試數據集，後續需將數據替換為完整的節點定義數據以保證準確性。

✨ 主要特性

• 節點圖工具：列出、讀取、寫入和驗證 GraphDocument Json文件。
• 項目工具：讀取/寫入包含 manifest.json 和節點圖文件的文件夾。
• 節點索引：一個小型的節點定義樣本文件，以及用於完整數據的覆蓋路徑。
• 文檔資源：通過MCP資源（nodegraph://docs/...）公開的文檔資源。

📦 安裝指南

克隆倉庫

git clone https://github.com/Columbina-Dev/WebMiliastraNodesEditor-MCPServer.git

進入項目目錄

cd WebMiliastraNodesEditor-MCPServer/

安裝依賴

npm install

構建項目

npm run build

啟動服務器

node build/index.js

📚 詳細文檔

倉庫目錄

• graphs/ - 節點圖Json文件（節點圖工具的默認目標）
• projects/ - 項目文件夾（每個文件夾包含 manifest.json 和節點圖文件）
• docs/ - 作為MCP資源提供的參考文檔
• data/ - 節點定義數據（將在後續根據 data.ts 完善數據）

MCP 配置示例

🔧 技術細節

該項目90%以上代碼均由AI生成。

📄 許可證

與 主項目 相同，此MCP服務器項目同樣採用GPLv3許可證。

⚠️ 注意事項

• 需根據官方編輯器教程HTML導入更多的參考文檔，見 docs/tutorial-plan.md。
• 目前為臨時測試MCP服務器，幾乎無法生成正常可用的節點圖和項目文件，需在後續完善文檔和節點定義數據以驗證格式。