modrinth-mcp

Modrinth API をラップする MCP サーバーで、AI エージェント（Claude Code、Claude Desktop、Cursor など）がプロジェクトの検索、プロジェクト/バージョンのメタデータの読み取り、そして Minecraft の MOD の公開（プロジェクトの作成やビルド済み jar の新バージョンとしてのアップロード）を行えるようにします。

ツール

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

Related MCP server: ModWrench MCP Server

トークンの取得

https://modrinth.com/settings/pats で以下のスコープを持つ PAT を作成します：

• プロジェクトの読み取り

• バージョンの読み取り

• バージョンの作成

• バージョンの書き込み

これを MODRINTH_TOKEN 環境変数として設定します。

インストール

Claude Code プラグインとして

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

プラグインを有効にする際に Modrinth トークンの入力を求められます。内部では npx 経由で公開済みの npm パッケージを実行します。

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

環境変数

使用例

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