Runescape Wiki MCP

🚀 ルーンスケイプウィキMCPサーバー

ルーンスケイプウィキのAPIにアクセスできるModel Context Protocol (MCP)サーバーです。ルーンスケイプ3 (RS3)のリアルタイムのグランドエクスチェンジ価格、アイテムデータ、プレイヤー統計情報などが取得できます。

✨ 主な機能

• リアルタイムのグランドエクスチェンジ価格：すべてのアイテムの現在、5分間、1時間の平均価格を取得できます。
• アイテムデータベース：メタデータ（名前、ID、調査テキストなど）を含む完全なアイテムマッピングにアクセスできます。
• 価格時系列データ：設定可能な時間間隔での過去の価格データを取得できます。
• プレイヤー統計情報：ルーンスケイプ3のハイスコアからプレイヤーの統計情報を検索できます。
• 複数のゲームモード：ノーマル、アイアンマン、ハードコアアイアンマンアカウントをサポートしています。
• MCPリソース：MCPリソースURIを通じて価格とアイテムデータに直接アクセスできます。

📦 インストール

前提条件

• Node.js 18.0.0以上
• npmまたはyarn

依存関係のインストール

npm install

プロジェクトのビルド

npm run build

開発モード

npm run dev

これにより、TypeScriptコンパイラがウォッチモードで起動し、ファイルが変更されると自動的にサーバーが再起動します。

💻 使用例

Claude Desktopでの使用

Claude Desktopの設定ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "runescape-wiki": {
      "command": "node",
      "args": ["/path/to/runescape-wiki-mcp/dist/index.js"]
    }
  }
}

MCP Inspectorでの使用

MCP Inspectorを使用してサーバーをテストします。

# npmスクリプトを使用する（推奨）
npm run inspector

# またはnpxで手動で実行
npx @modelcontextprotocol/inspector node dist/index.js

クイックテスト

サーバーが正常に動作していることを確認します。

npm test

利用可能なツール

get_latest_prices

すべてのアイテムまたは特定のアイテムの最新のグランドエクスチェンジ価格を取得します。 パラメーター：

• itemId (オプション)：特定のアイテムの価格を取得するためのアイテムID

例：

{
  "itemId": 4151
}

get_item_mapping

すべてのアイテムのID、名前、メタデータを含む完全なマッピングを取得します。 パラメーター：なし 戻り値：以下の情報を含むアイテムの配列

• id：アイテムID
• name：アイテム名
• examine：調査テキスト
• members：メンバー限定アイテムかどうか
• lowalch：低アルケミー価値
• highalch：高アルケミー価値
• limit：グランドエクスチェンジの購入制限
• value：アイテムの価値
• icon：アイコンファイル名

get_5m_prices

すべてのアイテムの5分間の平均価格を取得します。 パラメーター：

• timestamp (オプション)：特定の時間の価格を取得するためのUnixタイムスタンプ

get_1h_prices

すべてのアイテムの1時間の平均価格を取得します。 パラメーター：

• timestamp (オプション)：特定の時間の価格を取得するためのUnixタイムスタンプ

get_timeseries

特定のアイテムの価格時系列データを取得します。 パラメーター：

• itemId (必須)：時系列データを取得するアイテムID
• timestep (必須)：時間間隔 - 5m、1h、6h、24hのいずれか

例：

{
  "itemId": 4151,
  "timestep": "1h"
}

get_player_stats

ルーンスケイプ3のハイスコアからプレイヤーの統計情報を取得します。 パラメーター：

• username (必須)：検索するプレイヤーのユーザー名
• gameMode (オプション)：ゲームモード - normal、ironman、hardcoreのいずれか

例：

{
  "username": "Zezima",
  "gameMode": "normal"
}

戻り値：解析された統計情報。以下を含みます。

• 全体のランクと総レベル
• 個々のスキルのレベル、経験値、ランク
• すべての30のスキル（召喚術、ダンジョニアリング、占い術、発明術、考古学、死霊術を含む）のフォーマットされたデータ

アイテムカテゴリマッピング

search_itemsなど、カテゴリ番号を必要とするツールを使用する際は、この表を参照してください。

利用可能なリソース

runescape://prices/latest

すべてのアイテムの最新のグランドエクスチェンジ価格に直接アクセスできます。

runescape://items/mapping

完全なアイテムマッピングデータに直接アクセスできます。

📚 詳細ドキュメント

このサーバーは以下のルーンスケイプウィキのAPIを使用しています。

• RS3 Prices API：https://prices.runescape.wiki/api/v1/rs
  • 最新価格、5分間平均、1時間平均、時系列データ
• RS3 Hiscores API：https://secure.runescape.com/m=hiscore
  • 異なるゲームモードのプレイヤー統計情報

レート制限

ルーンスケイプウィキのAPIには以下のガイドラインがあります。

• 説明的なUser - Agentを使用する（このサーバーで自動的に処理されます）
• APIの安定性に影響を与える可能性のある過度のリクエストを避ける
• サーバーは適切なエラーハンドリングを実装しており、APIの制限を尊重します。

エラーハンドリング

サーバーには包括的なエラーハンドリングが含まれています。

• APIリクエストの失敗は捕捉され、エラーレスポンスとして返されます。
• 無効なパラメーターはAPI呼び出し前に検証されます。
• ネットワークタイムアウトや接続問題は適切に処理されます。
• プレイヤーが見つからないエラーは適切に報告されます。

開発

プロジェクト構造

src/
├── index.ts          # メインサーバーの実装
├── types/            # TypeScriptの型定義
└── utils/            # ユーティリティ関数

dist/                 # コンパイルされたJavaScriptの出力

スクリプト

• npm run build：TypeScriptをJavaScriptにコンパイルします。
• npm run watch：変更を監視して再コンパイルします。
• npm start：本番モードでサーバーを起動します。
• npm run dev：自動再起動付きの開発モードで起動します。
• npm test：サーバーが正常に動作していることを確認するための簡単なテストを実行します。
• npm run inspector：MCP Inspectorを起動してサーバーをテストします。

新しいツールの追加

1. tools配列に適切なスキーマでツールを定義します。
2. CallToolRequestSchemaハンドラーにケースハンドラーを追加します。
3. 適切なエラーハンドリングを伴うAPIロジックを実装します。
4. このREADMEをドキュメントで更新します。

コントリビュート

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合はテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

謝辞

• RuneScape Wiki がAPIを提供してくれたこと
• Model Context Protocol のMCP仕様
• Jagex がルーンスケイプ3を提供してくれたこと

サポート

問題、質問、または機能リクエストについては、GitHubリポジトリでイシューを開いてください。

注意：これは非公式のツールであり、Jagexやルーンスケイプウィキとは関係ありません。APIの使用ガイドラインとサービス利用規約を尊重してください。