modrinth-mcp

一个封装了 Modrinth API 的 MCP 服务器，使 AI 代理（Claude Code、Claude Desktop、Cursor 等）能够搜索项目、读取项目/版本元数据，以及发布 Minecraft 模组——创建项目并上传构建好的 jar 作为新版本。

工具

只读工具无需令牌即可使用。任何写入操作都需要 Modrinth 个人访问令牌。

Related MCP server: ModWrench MCP Server

获取令牌

在 https://modrinth.com/settings/pats 创建一个个人访问令牌，并授予以下权限：

• 读取项目

• 读取版本

• 创建版本

• 写入版本

将其设置为 MODRINTH_TOKEN 环境变量。

安装

作为 Claude Code 插件

/plugin marketplace add justinscott12/modrinth-mcp
/plugin install modrinth-mcp@justinscott12

启用插件时，系统会提示你输入 Modrinth 令牌。它通过 npx 在底层运行已发布的 npm 包。

作为 MCP 服务器（任意客户端）

将以下内容添加到你的 MCP 客户端配置中（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "modrinth": {
      "command": "npx",
      "args": ["-y", "@justinscott12/modrinth-mcp"],
      "env": {
        "MODRINTH_TOKEN": "your-modrinth-pat"
      }
    }
  }
}

或者直接在 Claude Code 中配置：

claude mcp add modrinth --env MODRINTH_TOKEN=your-modrinth-pat -- npx -y @justinscott12/modrinth-mcp

环境变量

示例流程

1. modrinth_whoami — 确认认证正常。

2. modrinth_create_project — 创建项目页面（作为草稿创建）。

3. modrinth_create_version — 上传你构建好的 jar，并指定目标 game_versions 和 loaders。

4. 准备就绪后，在 Modrinth 网站上提交项目进行审核。

注意： create_version 和 create_project 会发布公开内容。请仅在确实打算发布时调用它们。

开发

npm install
MODRINTH_STAGING=1 MODRINTH_TOKEN=your-staging-pat npm start

该服务器通过 stdio 进行 MCP 通信。stdout 保留给协议使用；日志输出到 stderr。

许可证

MIT