Monster Hunter World Helper MCP Server

Monster Hunter World Helper MCP Server

MHW DB API を介して Monster Hunter World のゲームデータにアクセスするためのツールとリソースを提供する MCP（Model Context Protocol）サーバーです。

機能

リソース

• monster://{id} - 特定のモンスターに関する詳細情報を取得します
• armor-set://{id} - 特定の防具セットに関する詳細情報を取得します

ツール

• find-monster - モンスターを名前で検索し、弱点、場所、種族などの詳細情報を取得します
• find-weapon-path - 必要な素材をすべて含む、武器の完全な生産ツリーの経路を取得します
• find-armor-by-skill - 特定のスキルを持つ防具を検索します

プロンプト

• monster-guide - 特定のモンスターの包括的な狩猟ガイドを取得します
• farming-guide - 特定のアイテムを効率よく集める方法を取得します
• build-planner - 武器種とプレイスタイルに基づいたビルドのおすすめを取得します

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. サーバーを起動します：

npm run dev

サーバーは stdio モードで起動し、.roo/mcp.json 設定ファイルがある場合は Roo に自動的に接続します。

使用例

モンスター情報の検索

// Example tool usage through Roo
const result = await tool.use("find-monster", { name: "Rathalos" });

レスポンスには以下が含まれます：

• モンスター名とタイプ
• 種族情報
• 出現場所
• 属性・状態異常の弱点
• 説明

武器の生産経路の取得

// Example tool usage through Roo
const result = await tool.use("find-weapon-path", {
  name: "Defender Greatsword",
});

レスポンスには以下が含まれます：

• 完全な強化経路
• 各段階で必要な素材
• 素材の入手元・説明

スキルで防具を検索

// Example tool usage through Roo
const result = await tool.use("find-armor-by-skill", { skill: "Attack Boost" });

レスポンスには以下が含まれます：

• 条件に一致する防具の一覧
• 防具のステータスとレア度
• スキルレベル
• 生産条件

モンスターの狩猟ガイドの取得

// Example prompt usage through Roo
const result = await prompt.use("monster-guide", { monster: "Nergigante" });

レスポンスには以下が含まれます：

1. 弱点と耐性
2. おすすめの武器・属性
3. 持参する重要アイテム
4. 注意すべき重要なメカニクス
5. おすすめの防具スキル

API の詳細

リソースのエンドポイント

モンスターリソース（monster://{id}）

MHW DB API からモンスターの詳細情報を返します。

防具セットリソース（armor-set://{id}）

MHW DB API から防具セットの詳細情報を返します。

ツールのパラメーター

find-monster

• name（string）：検索するモンスター名の全部または一部

find-weapon-path

• name（string）：検索する武器名の全部または一部

find-armor-by-skill

• skill（string）：検索するスキル名の全部または一部

プロンプトのパラメーター

monster-guide

• monster（string）：ガイドを取得するモンスターの名前

farming-guide

• item（string）：集め方を取得するアイテムの名前

build-planner

• weapon（string）：ビルドに使用する武器種
• playstyle（string）：希望するプレイスタイル（例：「防御重視」、「DPS」など）

エラー処理

サーバーには、包括的なエラー処理とログ記録が備わっています：

• API 接続エラー
• リソースが見つからないエラー
• 無効なパラメーターのエラー

デバッグに役立つ詳細情報とともに、すべてのエラーがコンソールに適切に記録されます。

開発

このサーバーは TypeScript で構築され、以下を使用しています：

• Model Context Protocol（MCP）SDK
• パラメーター検証のための Zod
• MHW DB API リクエストのための Fetch API
• API レスポンスのインメモリーキャッシュ

サーバーを変更または拡張するには：

1. mhw-mcp-server.ts を変更します
2. npm run dev を使用すると、サーバーが自動的に再読み込みされます

コントリビューション

コントリビューションを歓迎します！新機能、修正、改善を含むプルリクエストをお気軽にお送りください。

ライセンス

MIT License - このプロジェクトは自由にご利用ください。