mc-rp-assistant-mcp
Allows searching Modrinth for resource packs by name or tag, and retrieving detailed information about a pack via slug or project ID.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mc-rp-assistant-mcp compare my resource pack with the vanilla one"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mc-rp-assistant-mcp
MCP server for Minecraft resource pack analysis, validation, and management. Reads pack.mcmeta, validates structure, lists assets, compares packs, and queries Modrinth.
Tools
Tool | Description |
| Read pack.mcmeta from a resource pack directory or .zip file |
| Validate a resource pack's structure and flag issues (missing files, format mismatches, large icons, etc.) |
| List all asset paths (textures/models/sounds/lang) in a pack. Supports both directories and .zip files |
| Compare two resource packs and report added, removed, and changed asset files |
| Search Modrinth for resource packs by name or tag. Returns up to |
| Get detailed info about a Modrinth resource pack by its slug or project ID |
| Validate textures for size limits (>2MB), naming conventions (lowercase, no spaces), and pack icon size |
| Analyze language files (.lang) and detect missing translations across languages |
| Compare two resource packs with detailed per-file info including file sizes for added/removed/changed assets |
Related MCP server: mc-pack-builder-mcp
Exported Functions
readPackMetaExport(packPath)— Read pack.mcmetavalidateRpStructureExport(packPath, mcVersion?)— Validate pack structurelistRpAssetsExport(packPath, limit?)— List asset filescompareRpacksExport(oldPackPath, newPackPath)— Compare two packssearchRpOnModrinthExport(query, limit?)— Search ModrinthgetRpInfoExport(slugOrId)— Get pack info from ModrinthvalidateTexturesExport(packPath)— Validate texturesanalyzeLangFilesExport(packPath)— Analyze language filescompareRpacksDiffExport(oldPackPath, newPackPath)— Detailed pack comparison
MCP Client Configuration
Add to your MCP client config (e.g., Trae settings.json or MCP CLI config):
{
"mcpServers": {
"mc-rp-assistant": {
"command": "node",
"args": ["${workspaceFolder}/dist/index.js"]
}
}
}Path note:
${workspaceFolder}resolves to the project root in Trae/VS Code. If using another editor, replace with the absolute path, e.g.["C:/Users/xxx/Desktop/mc-rp-assistant-mcp/dist/index.js"].
Configuration
本工具零配置即可用(内置默认值,任何环境开箱即用)。以下项目可通过环境变量或项目根目录 .env 文件覆盖(复制 .env.example 为 .env):
变量 | 默认值 | 说明 |
|
| Modrinth API 根地址,支持自建网关/代理 |
|
| 请求 User-Agent(Modrinth 要求标明来源) |
|
| 单张纹理大小上限(MB),超过则标记为大纹理 |
|
| 资源包图标 |
|
| Modrinth 资源包搜索默认返回条数 |
|
| Modrinth 搜索返回条数硬上限 |
优先级:环境变量 > .env 文件 > rp-config.json > 内置默认值。改动后重启 MCP server 生效。
扩展默认配置:编辑 src/rp-config.json(构建后为 dist/rp-config.json)可调整搜索上限、pack.png 大小阈值与 MC 版本 → pack_format 映射,无需改代码。
Requirements
Node.js 18+
@modelcontextprotocol/sdk,zod,adm-zipadm-zipis required for.zip/.mcpkgresource pack support — included as a dependency
Development
npm run build # Compile TypeScript
npm run test:unit # Run unit tests
npm test # Run all testsTesting
npm run build
npm testAll unit tests are offline except searchRpOnModrinth and getRpInfo which gracefully return empty results when no network is available.
Platform Compatibility
Tool | Windows | macOS | Linux |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
| ✅ | ✅ | ✅ |
All tools use cross-platform Node.js fs and path APIs. .zip support requires adm-zip. Network-dependent tools (search_rp_on_modrinth, get_rp_info) work on all platforms when online; they return empty results gracefully when offline.
Requirements
Node.js 18+
@modelcontextprotocol/sdk,zod,adm-zip
License
MIT
Available Tools
9 toolsanalyze_lang_filesA
Analyze language files (.lang) in a resource pack and detect missing translations across languages.
Inputs: packPath (required).
compare_rpacksB
Compare two resource packs and report added, removed, and changed asset files.
Inputs: newPackPath (required), oldPackPath (required).
compare_rpacks_diffB
Compare two resource packs with detailed per-file information including file sizes for added/removed/changed assets.
Inputs: newPackPath (required), oldPackPath (required).
get_rp_infoB
Get detailed info about a Modrinth resource pack by its slug or project ID.
Inputs: slugOrId (required).
list_rp_assetsB
List all asset paths (textures, models, sounds, lang) in a resource pack. Supports both directories and .zip files.
Inputs: packPath (required), limit.
read_packmetaA
Read pack.mcmeta metadata from a resource pack directory or zip file.
Inputs: packPath (required).
search_rp_on_modrinthC
Search Modrinth for resource packs by name or tag. Returns up to limit results.
Inputs: query (required), limit.
validate_rp_structureB
Validate a resource pack's structure and flag issues (missing files, format mismatches, large icons, etc.).
Inputs: packPath (required), mcVersion.
validate_texturesB
Validate textures in a resource pack for size limits (>2MB), naming conventions (lowercase, no spaces), and pack icon size.
Inputs: packPath (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools target distinct operations, but compare_rpacks and compare_rpacks_diff overlap almost entirely (the latter mainly adds per-file sizes), and validate_rp_structure vs validate_textures both cover pack icon/texture size concerns. Descriptions hint at differences but do not clearly define when to choose each.
Names overwhelmingly follow a snake_case verb_noun pattern, but domain abbreviations are inconsistent: rp, rpacks, packmeta, and lang appear without a single standard. Still readable and mostly predictable.
Nine tools is well within the appropriate range for a resource-pack analysis assistant, with each major capability represented. There is no significant bloat or extreme thinness.
The set covers metadata reading, structure validation, asset listing, pack comparison, texture validation, language analysis, and Modrinth lookup. Minor gaps remain around model/sound validation or pack modification, but core analysis workflows are covered.
Maintenance
Related MCP Connectors
Scan AI agent skills, MCP server packages and MCP configs before you install them. Static analysis.
Checks whether generated Minecraft Bedrock content will actually load. Nine read-only tools.
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
FiveM dev tools: find resources, check compatibility, validate Lua and server.cfg, generate jobs
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceValidates Minecraft datapack JSON files (recipes, advancements, loot tables, etc.) against official Minecraft data formats using Spyglass.MIT
- AlicenseAqualityBmaintenanceEnables creating Minecraft modpack structures, searching Modrinth mods, resolving dependencies, and checking compatibility.848 npmMIT
- AlicenseAqualityBmaintenanceEnables reading, validating, comparing, and cleaning up Minecraft mod configuration files in .cfg, .toml, and .json formats.651 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables Minecraft modpack development by generating FTB Quests chapters and tasks, KubeJS scripts (weapons, armor, recipes), validating SNBT/config files, and providing diagnostic checks.22 npmMIT