Modrinth MCP
概要
作者による説明(英語の原文)
Search Modrinth and publish Minecraft mods (create projects, upload versions) via the Modrinth API.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい↓ 331/週 · ★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: 検索・AIの記憶
- 入力が必要なもの:MODRINTH_TOKEN
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:1項目中1項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
- 自分で入力するもの:
MODRINTH_TOKEN
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
- npmNode.jsのインストール(npxコマンドに必要)
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"modrinth": {
"command": "npx",
"args": [
"-y",
"@justinscott12/modrinth-mcp"
],
"env": {
"MODRINTH_TOKEN": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add modrinth --env MODRINTH_TOKEN=your-value -- npx -y @justinscott12/modrinth-mcp動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"modrinth": {
"command": "npx",
"args": [
"-y",
"@justinscott12/modrinth-mcp"
],
"env": {
"MODRINTH_TOKEN": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"modrinth": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@justinscott12/modrinth-mcp"
],
"env": {
"MODRINTH_TOKEN": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- Modrinth Personal Access Token (https://modrinth.com/settings/pats). Required only for write actions; read-only tools work without it.
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント justinscott12 で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
検索・AIの記憶のほかのサーバーとの比較i
- このカテゴリのほかの5688件のうち0%よりスターが多い
- このカテゴリのほかの5688件のうち88%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの5688件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Modrinth MCPは安全ですか?
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:MODRINTH_TOKEN
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(0.1.3)がレジストリに届いたのは5 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Context7, Codebase Memory, Exa
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
modrinth-mcp
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 https://modrinth.com/settings/pats 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
/plugin marketplace add justinscott12/modrinth-mcp
/plugin install modrinth-mcp@justinscott12
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.:
# macOS/Linux (add to your shell profile to persist)
export MODRINTH_TOKEN=your-modrinth-pat
Windows PowerShell (persist for your user)
setx MODRINTH_TOKEN "your-modrinth-pat"
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):
{
"mcpServers": { "modrinth": { "command": "npx", "args": ["-y", "@justinscott12/modrinth-mcp"], "env": { "MODRINTH_TOKEN": "your-modrinth-pat" } } } }
Or in Claude Code directly:
claude mcp add modrinth --env MODRINTH_TOKEN=your-modrinth-pat -- npx -y @justinscott12/modrinth-mcp
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. |
MODRINTH_TIMEOUT_MS | 60000 | Per-request timeout. A stalled request returns a tool error instead of hanging. |
MODRINTH_API_URL | – | Override the API base URL (for a proxy or tests). Takes precedence over MODRINTH_STAGING. |
Example flow
modrinth_whoami— confirm auth works.modrinth_create_project— create the project page (created as a draft).modrinth_create_version— upload your built jar(s) with the targetgame_versionsandloaders.- Submit the project for review on the Modrinth site when ready.
Note:
create_versionandcreate_projectpublish public content. Only call them when you actually intend to publish.
Development
npm install
MODRINTH_STAGING=1 MODRINTH_TOKEN=your-staging-pat npm start
The server speaks MCP over stdio. stdout is reserved for the protocol; logs go to stderr.
npm test runs the server over stdio against a local stub (no Modrinth calls).
The server ignores SIGINT/SIGBREAK and exits when the client closes stdin. A console Ctrl+C or Ctrl+Break reaches every process on the console, and on Windows npx runs the server through a .cmd shim: if node exited, cmd.exe would keep the pipe open at a Terminate batch job (Y/N)? prompt and every later tool call would hang. Node can't simulate that on Windows, so check it by hand there: send GenerateConsoleCtrlEvent to a shim-launched server and confirm tools/list still answers.
License
MIT