io.github.mrfentmen/modrinth-mcp

Official

by mrfentmen · TypeScript

Use this MCP server to Modrinth, search Minecraft mods, filter by loader and game version,...

io.github.mrfentmen/modrinth-mcp (MCP Server)

This MCP server provides access to Modrinth for working with Minecraft mods. It supports mod search on Modrinth and allows filtering results by loader and game version.

🛠️ Key Features

Use this MCP server to access Modrinth
Search Minecraft mods
Filter by loader
Filter by game version

🚀 Use Cases

Retrieve Modrinth mod results via an MCP client
Narrow mod listings to a specific Minecraft loader
Limit results to a specific Minecraft game version

⚡ Developer Benefits

Structured Modrinth querying through MCP
Parameter-based refinement using loader and game version filters

⚠️ Limitations

Available feature details are limited to Modrinth search and filtering by loader and game version based on the provided description.

README.md1 KBView on GitHub

modrinth mcp

Search Modrinth, the modern Minecraft mod host, with full loader / game version filtering. No key.

Tools

search_mods, query + filters: loader (fabric/forge/neoforge/quilt), MC version
get_mod, description, loaders, supported versions, downloads/follows
get_mod_versions, versions with download links + required dependencies

Run

bash

npm install && npm run build && node dist/index.js

Example

"Sodium for Fabric 1.20.1" search_mods("sodium", loader="fabric", gameVersion="1.20.1") → get_mod_versions("sodium", "fabric", "1.20.1") → Sodium 0.5.13, 10.2M downloads

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "modrinth-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/modrinth-mcp@1.0.1"
      ]
    }
  }
}