dsh-modrinth-mcp

DeepSeek Harness(DSH)から Modrinth API v2 をネイティブツールとして使えるようにする、依存ゼロの MCP サーバー(stdio)。

@deepseek-ai/dsh-mcp-client ブリッジで登録すると mcp__modrinth__* の9ツールが生えます。DSH 以外の MCP クライアント(Claude Code / Codex 等の汎用 mcpServers 設定)でもそのまま動きます。

特徴

• 依存ゼロ — Node.js 標準機能のみ。newline-delimited JSON-RPC 2.0 を直実装しているので npm install 不要

• レスポンス最適化 — Modrinth の生レスポンスは巨大(ウィキ HTML 本文・全バージョン配列・ギャラリー等)。全ツールでモデルに必要なフィールドだけにトリムし、search_projects の1ヒットは約500バイト程度に収まる

• プロトコルの落とし穴を回避済み — Modrinth の配列クエリパラメータは JSON 配列形式が必須(?loaders=["fabric"])。カンマ区切り(?loaders=fabric)は 黙って無視され全件返る(実測)。本サーバーは常に正しい形式で送る

• 429/5xx の単発リトライ内蔵(Retry-After尊重)、タイムアウト 30秒/リクエスト

• 読み取りは認証不要(300 req/min)。MODRINTH_PAT を設定すればレート制限を緩和

Related MCP server: Minecraft Wiki MCP Server

ツール一覧(9)

DSH へのインストール

git clone https://github.com/motchii709/dsh-modrinth-mcp

~/.dsh/profiles/web/cordis.patch.yml に追記(node のパス・サーバーのパスは環境に合わせて変更):

- insert:
    - id: mcp-modrinth
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: modrinth
        transport: stdio
        command: node
        args:
          - 'C:\path\to\dsh-modrinth-mcp\modrinth-mcp.mjs'
        env:
          MODRINTH_PAT: !!js process.env.MODRINTH_PAT || ''
        failOnStartupError: false
        toolCallTimeoutMs: 60000

ホスト再起動(または HMR 反映)後、新規セッションで mcp__modrinth__search_projects 等が使えるようになります。

その他の MCP クライアント

{
  "mcpServers": {
    "modrinth": {
      "command": "node",
      "args": ["/path/to/dsh-modrinth-mcp/modrinth-mcp.mjs"]
    }
  }
}

開発

node test/server-test.mjs                    # JSON-RPC往復 + 実API呼び出しの回帰テスト
node test/server-test.mjs ./modrinth-mcp.mjs # サーバーファイルを明示指定する場合

テストは Modrinth 本番 API に実際にアクセスします(読み取りのみ・レート制限内)。

対応バージョン

• Node.js 18+(global fetch 利用)

• DSH 0.1.1-rc.2(web プロファイル、@deepseek-ai/dsh-mcp-client 同梱版)で動作確認

ライセンス

MIT