Mod Organizer MCP

mod组织者mcp

只读 主控程序 服务器 模组管理器2：阅读 modlist.txt，可选 plugins.txt / loadorder.txt，每mod meta.ini 在...之下 MO2_MODS_DIR.暴露一个完整的 mo2_profile_snapshot，轻便 mo2_profile_machine_contract （路径+归档根目录，无 mods[] /meta），可选 mo2_profile_plugin_load_order, mo2_skse_plugins （SKSE） Plugins .dll 具有MO2覆盖语义的库存），加上摘要、磁盘上的Nexus字段、松散文件冲突等。 没有写 到您的MO2或游戏目录。

需求

• 转到1.26+
• 环境变量（绝对路径）。在WSL上，Windows驱动器通常是 /mnt//... （例如。 S: → /mnt/s/...).

构建

go build -o mod-organizer-mcp ./cmd/server

Docker（如果您已经在Docker中运行了其他MCP，建议使用）

构建一次：

docker build -t mod-organizer-mcp:local .

容器无法访问您的磁盘，直到您 绑定支架 MO2数据树。绘制你的真实地图 MO2_data （或同等） /mo2 在容器内部，然后将env变量指向路径 在...之下 /mo2:

docker run --rm -i \
  -e MO2_PROFILE_DIR=/mo2/profiles/MyProfile \
  -e MO2_MODS_DIR=/mo2/mods \
  -v "/path/to/MO2_data:/mo2:ro" \
  mod-organizer-mcp:local

可选--游戏 Data 为了 mo2_skse_plugins: 使用工具参数 game_data_dir 容器内部（基线 SKSE/Plugins 来自真实游戏的提供者 GameData，最低优先级），挂载游戏 Data 将文件夹移动到以下路径 /game_data 并通过 game_data_dir": "/game_data" 在工具调用中（对此没有envvar）。

docker run --rm -i \
  -e MO2_PROFILE_DIR=/mo2/profiles/MyProfile \
  -e MO2_MODS_DIR=/mo2/mods \
  -v "/path/to/MO2_data:/mo2:ro" \
  -v "/path/to/Skyrim Special Edition/Data:/game_data:ro" \
  mod-organizer-mcp:local

使用 :ro 因此，即使错误回归，该过程也无法编写MO2树。

运行（stdio，用于光标）

export MO2_PROFILE_DIR="/path/to/MO2_instance/MO2_data/profiles/MyProfile"
export MO2_MODS_DIR="/path/to/MO2_instance/MO2_data/mods"
./mod-organizer-mcp

可选HTTP传输（与其他Go MCP服务器相同的模式）：

export MCP_TRANSPORT=http
export MCP_HTTP_ADDR=":8080"
./mod-organizer-mcp

光标MCP配置示例

Docker（stdio，与nexusmods mcp的想法相同）

安装 主机 MO2_data 在 /mo2 在容器中；env变量使用 集装箱内 路径。

{
  "mcpServers": {
    "mod-organizer-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MO2_PROFILE_DIR=/mo2/profiles/MyProfile",
        "-e",
        "MO2_MODS_DIR=/mo2/mods",
        "-v",
        "/path/to/MO2_data:/mo2:ro",
        "-v",
        "/path/to/Skyrim Special Edition/Data:/game_data:ro",
        "mod-organizer-mcp:local"
      ]
    }
  }
}

替换 /path/to/MO2_data 包含以下内容的目录 profiles/ 和 mods/ （在WSL上，通常类似 /mnt/s/Games/MO2_data).配置文件名称(MyProfile)必须与下的文件夹匹配 profiles/第二个 -v 行是可选的：如果不需要，请省略它 mo2_skse_plugins 和 game_data_dir": "/game_data".首先构建映像： docker build -t mod-organizer-mcp:local . 在这个回购中。

原生二进制或 go run

根据布局调整路径。带空格的路径必须在JSON中引用。

{
  "mcpServers": {
    "mod-organizer-mcp": {
      "command": "/path/to/mod-organizer-mcp",
      "env": {
        "MO2_PROFILE_DIR": "/path/to/MO2_instance/MO2_data/profiles/MyProfile",
        "MO2_MODS_DIR": "/path/to/MO2_instance/MO2_data/mods"
      }
    }
  }
}

如果二进制文件存在于其他地方，请使用 go build 输出路径或 "command": "go" 和 "args": ["run", "-C", "/path/to/mod-organizer-mcp", "./cmd/server"] （启动速度较慢）。

工具

安全和政策

• 此服务器 只阅读 文件夹。它不会修改 modlist.txt, meta.ini或其他任何东西。
• 更喜欢a 复制 当Mod Organizer运行时，可能会锁定文件。
• 将Skyrim/MO2树下的路径视为敏感路径：仅在以下情况下授予工具或代理的写访问权限 你 在上下文中明确允许它（此MCP不写）。

WSL:Windows驱动器不可见

如果工具因以下错误而失败 Transport endpoint is not connected 或 no such file 在...之下 /mnt/:

1. 确保驱动器安装在WSL中(/mnt/s 或 /mnt/c 存在并列出MO2所在的文件夹）。
2. 从Windows运行 wsl --mount 或者在访问后打开发行版 S: 一次，取决于您的WSL版本和 wsl.conf 自动装载设置。
3. 使用 mo2_server_info 固定支架后，确认路径已解决。

Nexus模组

• 此MCP 暴露 mo2_nexus_local_index：存储在任何MO2中 meta.ini （id、版本、文件名）。将其视为 本地缓存它可能已经过时了。
• 实时Nexus （当前文件版本、描述、依赖关系）：使用 分开 与Nexus Mods API对话的MCP（您信任的任何实现）。典型流程： mo2_nexus_local_index 或 mo2_mod_lookup → 然后从磁盘中获取具有mod/file-id的MCP。

积压（此处未实施）

主控程序 资源 (mo2://… URI），可选 MO2_INSTANCE_DIR + modorganizer.ini，解析MO2 webcache, BSA/BA2 索引，更严格 USVFS 平价留给未来的工作。

代理人备注

• 更喜欢 mo2_profile_summary 仅用于计数； mo2_profile_machine_contract 当您需要INI/列表路径/归档根目录而无需步行时 meta.ini 或返回 mods[] （使用 only_enabled / mod_name_prefix 收缩 archive_search_roots).
• 使用 mo2_profile_plugin_load_order 仅在MO2中流动；如果 诱变剂 已配置，首选 mutagen_list_plugins 用于订购插件+磁盘分辨率。
• mo2_profile_snapshot 接受与以前相同的过滤器，另外 include_contract （默认打开）和 include_plugin_load_order （默认关闭）。窄与 include_meta, mod_name_prefix, only_enabled 根据需要。
• 工具 参数模式 （包括过滤器）从Go结构中推断出来，并通过以下方式暴露给MCP客户端 tools/list (jsonschema 字段上的标签）。
• 对于 SKSE原生插件 (.dll 在 SKSE/Plugins)，呼叫 mo2_skse_plugins；通行证 game_data_dir 作为游戏 Data 当您需要从磁盘获取基线DLL时（例如Docker挂载）。使用 include_pe_version 仅当您需要PE版本字符串时。
• 对于纹理/网格/脚本重叠，请调用 mo2_asset_conflicts 带着一个 path_prefix （和更低 max_files_total 如果需要），因此JSON保持有界。
• 上下文压缩后，重新调用 mo2_nexus_local_index 而不是对磁盘上已经存在的id重复相同的Nexus API请求。

公共回购/分叉

• .cursor/ 被忽略：IDE计划通常嵌入绝对本地路径；让他们远离git。
• go.mod 模块路径 (github.com/.../mod-organizer-mcp)应与您发布的Git URL匹配；分叉后，更换模块路径和所有 import 字符串（或使用标准Go分支指南中的多步重命名）。

许可证

除非添加许可证文件，否则不包括许可证文件。