OSRS MCP Server

OSRS MCP サーバー

Old School RuneScape（OSRS）Wiki API およびデータファイルとやり取りするための MCP サーバーです。このサーバーは、Model Context Protocol を通じて OSRS Wiki を検索し、ゲームデータの定義にアクセスするツールを提供します。

ツール

このサーバーでは、以下のツールを実装しています。

OSRS Wiki メソッド

1. osrs_wiki_search - 検索語に一致するページを OSRS Wiki で検索します
2. osrs_wiki_get_page_info - OSRS Wiki の特定のページに関する情報を取得します
3. osrs_wiki_parse_page - OSRS Wiki の特定のページの解析済み HTML コンテンツを取得します

ゲームデータ検索メソッド

4. search_varptypes - プレイヤーの状態や進行状況を保存するプレイヤー変数（varp）を varptypes.txt ファイルで検索します
5. search_varbittypes - varp の個々のビットを保存する変数ビット（varbit）を varbittypes.txt ファイルで検索します
6. search_iftypes - ゲームの UI で使われるインターフェース定義を iftypes.txt ファイルで検索します
7. search_invtypes - ゲーム内のインベントリータイプ定義を invtypes.txt ファイルで検索します
8. search_loctypes - ゲーム世界の場所／オブジェクトタイプ定義を loctypes.txt ファイルで検索します
9. search_npctypes - NPC（ノンプレイヤーキャラクター）の定義を npctypes.txt ファイルで検索します
10. search_objtypes - ゲーム内のオブジェクト／アイテム定義を objtypes.txt ファイルで検索します
11. search_rowtypes - さまざまなインターフェースで使われる行定義を rowtypes.txt ファイルで検索します
12. search_seqtypes - アニメーションシーケンス定義を seqtypes.txt ファイルで検索します
13. search_soundtypes - ゲーム内の効果音定義を soundtypes.txt ファイルで検索します
14. search_spottypes - スポットアニメーション（グラフィック効果）の定義を spottypes.txt ファイルで検索します
15. search_spritetypes - インターフェースで使われるスプライト画像の定義を spritetypes.txt ファイルで検索します
16. search_tabletypes - インターフェースのタブ定義を tabletypes.txt ファイルで検索します

汎用データファイルメソッド

17. search_data_file - data ディレクトリ内の任意のファイルを検索し、一致するエントリを探します
18. get_file_details - data ディレクトリ内のファイルの詳細を取得します
19. list_data_files - data ディレクトリ内で利用可能なデータファイルを一覧表示します

グランドエクスチェンジの価格

20. search_ge_items - 名前でグランドエクスチェンジの取引可能なアイテムを検索します。アイテム ID、名前、購入上限、錬金価値を返します
21. get_ge_latest - ID を指定して、特定のアイテムのグランドエクスチェンジにおける最新の最高価格と最低価格を取得します
22. get_ge_timeseries - 指定した間隔（5m、1h、6h、24h）で、アイテムの過去の時系列価格データを取得します。最大 365 件のデータポイントを返します

プレイヤー検索

23. lookup_player - 公式ハイスコアから OSRS プレイヤーの統計情報（スキル、ボス、クルースクロール、アクティビティ）を検索します

インストール

Smithery 経由でインストール

Smithery 経由で mcp-osrs を Claude Desktop に自動インストールするには：

npx @smithery/cli@latest install @jayarrowz/mcp-osrs --client claude

前提条件

• Node.js（v16 以降）
• npm または yarn

パッケージのインストール

# Clone the repository
git clone https://github.com/jayarrowz/mcp-osrs.git
cd mcp-osrs

# Install dependencies
npm install

# Build the package
npm run build

Claude Desktop での使用

以下を claude_desktop_config.json に追加します。

npx を使用

{
  "mcpServers": {
    "osrs": {
      "command": "npx",
      "args": ["-y", "@jayarrowz/mcp-osrs"]
    }
  }
}

Node.js を直接使用

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

/path/to/mcp-osrs をリポジトリの実際のパスに置き換えてください。

例

OSRS Wiki を検索

// Search for information about the Abyssal whip
const result = await callTool("osrs_wiki_search", { 
  search: "Abyssal whip" 
});

ページ情報を取得

// Get information about a specific wiki page
const pageInfo = await callTool("osrs_wiki_get_page_info", { 
  titles: "Abyssal_whip" 
});

ゲームデータを検索する

// Search for items in the object definitions
const items = await callTool("search_objtypes", { 
  query: "dragon",
  page: 1,
  pageSize: 10
});

利用可能なデータファイルを一覧表示する

// Get a list of all data files
const files = await callTool("list_data_files", {});

グランド・エクスチェンジのアイテムを検索する

// Search for tradeable items by name
const items = await callTool("search_ge_items", { 
  query: "dragon scimitar",
  page: 1,
  pageSize: 10
});

最新のGE価格を取得する

// Get the latest high/low prices for an item
const prices = await callTool("get_ge_latest", { 
  itemId: 2 // Cannonball
});

GE価格の履歴を取得する

// Get time-series price data for an item
const history = await callTool("get_ge_timeseries", { 
  itemId: 2,
  timestep: "1h"
});

プレイヤーを検索する

// Look up an OSRS player's stats
const stats = await callTool("lookup_player", { 
  playerName: "Zezima"
});

開発

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

ライセンス

このMCPサーバーはMITライセンスの下でライセンスされています。つまり、MITライセンスの条項に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリ内のLICENSEファイルをご覧ください。