用途
modrinth-mcp 是一个 MCP 服务器，封装了 Modrinth API，使 AI 代理（Claude Code、Claude Desktop、Cursor 等）能够搜索 Modrinth 上的项目、读取项目与版本元数据，并发布 Minecraft 模组——创建项目并将构建好的 jar 作为新版本上传。
主要能力
- 搜索 Modrinth 项目。
- 读取项目与版本元数据。
- 发布 Minecraft 模组：创建项目、上传构建好的 jar 作为新版本。
- 只读工具无需令牌即可使用；任何写入操作都需要 Modrinth 个人访问令牌（PAT）。
使用方式
获取令牌
在 https://modrinth.com/settings/pats 创建 PAT，所需权限范围为：
- Create versions
将其设置为 MODRINTH_TOKEN 环境变量。
作为 Claude Code 插件
该插件在底层通过 npx 运行已发布的 npm 包。Claude Code 插件没有令牌输入界面，因此服务器从 Claude Code 所运行环境中的 MODRINTH_TOKEN 环境变量读取令牌。在启动 Claude Code 之前设置该变量，然后重启 Claude Code 并运行 modrinth_whoami 以确认。只读工具（搜索、获取项目/版本）无需令牌即可使用。
作为 MCP 服务器（任意客户端）
添加到你的 MCP 客户端配置中（例如 Claude Desktop 的 claude_desktop_config.json），或直接在 Claude Code 中添加。
环境变量
- MODRINTH_TOKEN — 用于写入操作的 Modrinth 个人访问令牌。
可用工具
- modrinth_whoami — 确认认证是否有效。
- modrinth_create_project — 创建项目页面（以草稿形式创建）。
- modrinth_create_version — 使用目标 game_versions 和 loaders 上传构建好的 jar。
准备就绪后，在 Modrinth 网站上提交项目以供审核。
注意：create_version 和 create_project 会发布公开内容。请仅在你确实打算发布时调用它们。
该服务器通过 stdio 使用 MCP 协议；stdout 保留给协议使用，日志输出到 stderr。
