modrinth-mcp

modrinth-mcp

Modrinth API をラップする MCP サーバーです。AI エージェント（Claude Code、Claude Desktop、Cursor、…）がプロジェクトを検索し、プロジェクトやバージョンのメタデータを読み取り、Minecraft の MOD を公開できます。プロジェクトの作成や、ビルド済み jar の新しいバージョンとしてのアップロードも可能です。

ツール

ツール	認証	内容
modrinth_whoami	✅	トークンを検証し、認証済みユーザーを返します。
modrinth_search_projects	–	公開されている Modrinth プロジェクトを検索します。
modrinth_get_project	–	スラッグまたは ID でプロジェクトのメタデータを取得します。
modrinth_list_project_versions	–	プロジェクトの公開済みバージョンを一覧表示します。
modrinth_create_version	✅	1 つ以上の jar をアップロードして、新しいバージョンを公開します。
modrinth_create_project	✅	新しいプロジェクトを作成します（下書きとして作成されます）。
modrinth_modify_version	✅	既存のバージョンのメタデータを編集します。

読み取り専用のツールはトークンなしで使用できます。書き込みを行うには、Modrinth の Personal Access Token が必要です。

トークンの取得

https://modrinth.com/settings/pats で、次のスコープを指定して PAT を作成します。

• プロジェクトの読み取り
• バージョンの読み取り
• バージョンの作成
• バージョンの書き込み

MODRINTH_TOKEN 環境変数に設定してください。

インストール

Claude Code プラグインとして

/plugin marketplace add justinscott12/modrinth-mcp
/plugin install modrinth-mcp@justinscott12

内部では npx を介して公開済みの npm パッケージを実行します。Claude Code プラグインにはトークン入力 UI がないため、サーバーは Claude Code の実行環境にある MODRINTH_TOKEN 環境変数からトークンを読み取ります。Claude Code を起動する前に設定してください。例：

# 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"

その後、Claude Code を再起動し、modrinth_whoami を実行して確認します。読み取り専用の ツール（検索、プロジェクト／バージョンの取得）はトークンなしで使用できます。

MCP サーバーとして（任意のクライアント）

MCP クライアントの設定に追加します（例：Claude Desktop の claude_desktop_config.json）。

{
  "mcpServers": {
    "modrinth": {
      "command": "npx",
      "args": ["-y", "@justinscott12/modrinth-mcp"],
      "env": {
        "MODRINTH_TOKEN": "your-modrinth-pat"
      }
    }
  }
}

または、Claude Code で直接設定します。

claude mcp add modrinth --env MODRINTH_TOKEN=your-modrinth-pat -- npx -y @justinscott12/modrinth-mcp

環境変数

変数	デフォルト	用途
MODRINTH_TOKEN	–	Modrinth Personal Access Token。書き込み操作に必須です。
MODRINTH_STAGING	未設定	安全にテストするには 1 に設定し、https://staging-api.modrinth.com にアクセスします。
MODRINTH_USER_AGENT	modrinth-mcp/<version> …	Modrinth に送信する User-Agent を上書きします。

使用例

1. modrinth_whoami — 認証が機能することを確認します。
2. modrinth_create_project — プロジェクトページを作成します（下書きとして作成されます）。
3. modrinth_create_version — 対象の game_versions と loaders を指定して、ビルド済み jar をアップロードします。
4. 準備ができたら、Modrinth サイトでプロジェクトを審査に提出します。

注: create_version と create_project は公開コンテンツを公開します。実際に公開する意図がある場合にのみ呼び出してください。

開発

npm install
MODRINTH_STAGING=1 MODRINTH_TOKEN=your-staging-pat npm start

サーバーは stdio 経由で MCP を使用します。stdout はプロトコル専用です。ログは stderr に出力されます。

ライセンス

MIT