mcp-server-runescape

mcp-server-runescape

RuneScape（RS）とOld School RuneScape（OSRS）のデータを操作するツールを備えたMCP サーバーです。アイテム価格やプレイヤーのハイスコアなどを利用できます。

https://github.com/user-attachments/assets/7c141575-443b-4b76-8b33-6d48ec82fbe7

機能

このMCP サーバーは、正確な情報源のデータを使ってゲーム中の質問に回答するための、複数のツールを提供します。

1. アイテム詳細（get_item_details）

取引可能なアイテムに関する詳細情報を取得します。以下が含まれます。

• Grand Exchangeでの現在価格
• 価格の推移（24時間、30日、90日、180日）
• 名前
• カテゴリ
• 説明（調査テキスト）
• 画像
• メンバー向けかどうか
• ID

https://runescape.wiki/w/Application_programming_interface#detail

2. アイテム価格履歴（get_item_price_history）

過去180日間のアイテムの価格履歴を取得します。以下が含まれます。

• 指定日の価格（タイムスタンプ）
• 指定日の平均価格（タイムスタンプ）

https://runescape.wiki/w/Application_programming_interface#Graph

3. プレイヤーのハイスコア（get_player_hiscore）

任意のプレイヤーのスキルやアクティビティのランキングと経験値を取得します。以下が含まれます。

• プレイヤーの順位
• スキルレベル
• 経験値
• アクティビティスコア

https://runescape.wiki/w/Application_programming_interface#Hiscores_Lite_2

4. トップランキング（get_top_rankings）

特定のスキルまたはアクティビティの上位（最大50人）のプレイヤーを表示します。以下が含まれます。

• 名前
• スコア（スキルとアクティビティの両方に使用）
• 順位

https://runescape.wiki/w/Application_programming_interface#ranking

5. プレイヤー数（get_player_count）

現在RuneScapeとOld School RuneScapeにオンラインのプレイヤー数を取得します。以下が含まれます。

• リアルタイムのプレイヤー数

https://runescape.wiki/w/Application_programming_interface#player_count

6. アカウント総数（get_rsuser_total）

あらゆる形態のRuneScapeにアクセスできる、現在までに作成されたアカウント数を取得します。FunOrbや特定バージョンのRuneScapeで作成されたアカウントも含まれます。以下が含まれます。

• アカウント作成数の履歴データ

https://runescape.wiki/w/Application_programming_interface#rsusertotal

注記

一貫性を保つため、RSとOSRSの両方のデータに対応するAPIエンドポイントのみを使用するようにしました。

使用例

スクレイピング中に、情報源からより正確なデータを簡単に取得できるようにすることが目的です。

このMCP サーバーを使う際に、AIに尋ねられる質問の例を以下に示します。

アイテム詳細

"What is the price of a dragon scimitar in the Grand Exchange?"
"Torva full helm price"
"Current price of a dragon pickaxe"
"How much percentage has the price of a dragon pickaxe changed in the past 30 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 90 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 180 days?"
"Give me the description of an armadyl godsword"
"Give me the icon of a dragon scimitar"
"What is the id of an abbyssal whip?"

アイテム価格履歴

"Give me the price history of a dragon scimitar"
"Rune scimitar price on 1 april 2025?"

プレイヤーのハイスコア

"What rank is Zezima?"
"What rank is Zezima on runescape?"
"How much experience does Lynx Titan have overall?"
"Iron Hyger ironman rank?"

トップランキング

"Top 10 players overall?"
"Give me the top 50 attack rankings"
"Number one agility on runescape?"
"Most zulrah kills?"
"Give me the top 5 jad rankings"

はじめに

MCP サーバーの概要

次のようなさまざまなクライアントでMCP サーバーを使用できます。

• Claude desktop
• Cursor

1. 設定にMCP サーバーを追加する（NPMパッケージ）

クライアントが使用しているMCP設定に、このスニペットを貼り付けてください。

{
  "mcpServers": {
    "mcp-server-runescape": {
      "command": "npx",
      "args": ["-y", "mcp-server-runescape"]
    }
  }
}

設定ファイルは次の場所にあります（mac）。

• Claude desktop：

~/Library/Application Support/Claude/claude_desktop_config.json

• Cursor：

/Users/name/.cursor/mcp.json

2. ソースから実行する

必須 お使いのシステムにNode.jsがインストールされていること

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

   yarn
   

   または

   npm install
   

3. 次に、Claude desktopまたはCursorを以下のように更新します。

   {
     "mcpServers": {
       "mcp-server-runescape": {
         "command": "node",
         "args": ["/Users/path/to/mcp-server-runescape/src/server.js"]
       }
     }
   }
   

4. 任意：デバッガー／インスペクターを実行します

   yarn dev
   

   または

   npm run build
   

次の点を確認してください。

• /path/to/mcp-server-runescape を実際のインストール先のパスに置き換えてください。

設定を更新した後、変更を反映するためにClaude desktopまたはCursorを再起動してください。

個人的な好み

お好きなクライアントを使用できます。個人的には現時点でCursorとdeepseek-v3.1の組み合わせを気に入っており、とてもよく機能しています。

クライアント一覧

API ドキュメント

この MCP サーバーで使用する RuneScape API エンドポイントの詳細については、こちらをご覧ください： RS/Wiki API

謝辞

MCP サーバーについてもう少し学ぶため、週末に作りました。RuneScape は試す題材として最適でした。

• ドキュメントと API を提供してくれた rs/wiki チームに感謝します。

このツールがスクレイピングに役立ち、私を応援してくださる場合は、ぜひ