Nexus Mods MCP：135 个模组管理工具的 MCP 服务器

Nexus Mods MCP 是一款面向 Nexus Mods 平台的 Model Context Protocol 服务器，基于 Python + FastMCP 构建，通过 stdio 传输层暴露 135 个 MCP 工具。它同时封装了官方 REST API v1 和 GraphQL API v2，可以让任何 MCP 客户端（Claude Desktop、opencode、Cursor 等）直接用自然语言管理和探索游戏模组。

核心能力

• 135 个 MCP 工具：覆盖 Nexus Mods 全平台能力，包括 69 个只读工具 + 66 个写操作（mutations），涵盖游戏查询、模组浏览、文件下载、 endorsements、评论、收藏夹管理等
• 完整 API 覆盖：包含 v1 REST 和 v2 GraphQL 的全部端点，还额外提供了 v1 本身不提供的功能：自由文本模组搜索、批量查询、评论线程、收藏夹生命周期管理以及免限额的 GraphQL 读取
• 内置 TTL 缓存：会话内重复 GET 请求自动命中缓存，不消耗 API 配额（游戏数据缓存 1 小时，模组/文件数据缓存 5 分钟，GraphQL POST 缓存 60 秒）；个人状态（/user/*）永不被缓存
• 双重认证机制：开箱即用个人 API Key；可选 OAuth2（PKCE S256）支持自动刷新 token，用于 API Key 无法执行的写操作
• 安全下载：模组文件下载从 CDN 直落磁盘，全程 MD5 + SHA-256 校验，并提供可配置的大小上限保护
• 限流透明：每个 v1 响应都携带 Nexus 官方限流头部的快照（_rl 字段），方便 Agent 感知当前配额状态

安装配置

方式一：uvx（推荐，零安装）

uvx --from nexus-mods-mcp nexus-mcp

方式二：pipx

pipx install nexus-mods-mcp

方式三：pip

pip install nexus-mods-mcp

获取 API Key

在 Nexus Mods API 设置页 免费申请个人 API Key。

配置 MCP 客户端

零安装方式（推荐）：直接在客户端配置中使用 uvx 运行：

{
  "mcpServers": {
    "nexus": {
      "command": "uvx",
      "args": ["--from", "nexus-mods-mcp", "nexus-mcp"],
      "env": { "NEXUS_API_KEY": "你的Key" }
    }
  }
}

Claude Code 一键添加：

claude mcp add nexus -e NEXUS_API_KEY=你的Key -- uvx --from nexus-mods-mcp nexus-mcp

使用步骤

1. 申请 API Key：登录 Nexus Mods 后在用户账户页生成个人 API Key（免费）
2. 安装 MCP 服务器：任选 uvx / pipx / pip 任一方式安装
3. 配置客户端：在 Claude Code / Cursor / Claude Desktop 的 MCP 配置中加入 nexus 服务器
4. 自然语言探索：用自然语言让 Agent 查询游戏、搜索模组、获取模组详情
5. 执行管理操作：通过 Agent 完成 endorsements、下载管理、评论撰写等写操作（需配置 OAuth2）

适用场景

• 游戏模组情报收集：用 AI 自动监控特定游戏的最新模组发布、热度和更新动态
• 自动化模组管理：通过 Agent 自动完成批量 endorsements、收藏夹整理、评论回复
• 模组推荐引擎：基于用户偏好让 AI 分析 Nexus 平台数据，推荐高质量模组组合
• 游戏攻略创作：结合模组信息让 AI 撰写游戏攻略、配置指南
• 跨平台模组对比：通过 Agent 对比多个游戏的模组生态差异

适用人群

• PC 游戏玩家，尤其是喜欢定制游戏体验的资深玩家
• 游戏攻略作者与内容创作者
• 使用 Claude Code / Cursor 进行游戏相关项目的开发者
• 游戏媒体与垂直资讯网站的内容编辑

工作原理

Nexus Mods MCP 基于 FastMCP 框架构建，服务器以 stdio 子进程方式运行，不占用端口、不需要后台守护进程也不依赖数据库。客户端通过标准输入/输出与服务器通信，所有请求经过 MCP 协议标准化后，对 Nexus Mods REST API v1 和 GraphQL API v2 发起实际调用。工具层统一处理了认证（支持 API Key 和 OAuth2 两种模式）、缓存（TTL 内复用结果）、限流（感知并尊重平台限制）和错误处理，Agent 只需关注业务逻辑，无需处理底层 HTTP 细节。

官方链接

• PyPI：https://pypi.org/project/nexus-mods-mcp/
• GitHub：https://github.com/Talya1412/nexus-mcp