MCP server for searching Modrinth and publishing Minecraft mods via the Modrinth API. npm package + Claude Code plugin.
modrinth-mcp
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
An MCP server that wraps the Modrinth API so an AI agent (Claude Code, Claude Desktop, Cursor, …) can search projects, read project/version metadata, and **publish Minecraft mods** — create projects and upload built jars as new versions.
Tools
| Tool | Auth | What it does |
| --- | --- | --- |
| modrinth_whoami | ✅ | Verify your token; return the authenticated user. |
| modrinth_search_projects | – | Search public Modrinth projects. |
| modrinth_get_project | – | Get a project's metadata by slug or id. |
| modrinth_list_project_versions | – | List a project's published versions. |
| modrinth_create_version | ✅ | Publish a **new version** by uploading one or more jars. |
| modrinth_create_project | ✅ | Create a **new project** (as a draft). |
| modrinth_modify_version | ✅ | Edit metadata of an existing version. |
Read-only tools work without a token. Anything that writes needs a Modrinth **Personal Access Token**.
Getting a token
Create a PAT at with these scopes:
- Read projects
- Read versions
- Create versions
- Write versions
Set it as the MODRINTH_TOKEN environment variable.
Install
As a Claude Code plugin
It runs the published npm package under the hood via npx. Claude Code
plugins have no token-entry UI, so the server reads its token from the
MODRINTH_TOKEN **environment variable** in the environment Claude Code
runs in. Set it before launching Claude Code, e.g.:
Then restart Claude Code and run modrinth_whoami to confirm. Read-only
tools (search, get project/versions) work without a token.
As an MCP server (any client)
Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):
Or in Claude Code directly:
Environment variables
| Variable | Default | Purpose |
| --- | --- | --- |
| MODRINTH_TOKEN | – | Modrinth Personal Access Token. Required for write actions. |
| MODRINTH_STAGING | unset | Set to 1 to hit https://staging-api.modrinth.com for safe testing. |
| MODRINTH_USER_AGENT | modrinth-mcp/ … | Override the User-Agent sent to Modrinth. |
Example flow
1. modrinth_whoami — confirm auth works.
2. modrinth_create_project — create the project page (created as a draft).