OSRS MCP サーバー

Old School RuneScape (OSRS) Wiki APIおよびデータファイルと連携するためのMCPサーバー。このサーバーは、OSRS Wikiを検索し、モデルコンテキストプロトコルを介してゲームデータ定義にアクセスするためのツールを提供します。

ツール

このサーバーは次のツールを実装します。

OSRS Wikiメソッド

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

ゲームデータの検索方法

search_varptypes - プレイヤーの状態と進行状況を保存するプレイヤー変数 (varp) を varptypes.txt ファイルで検索します。
search_varbittypes - varbittypes.txt ファイルで、varps の個々のビットを格納する変数ビット (varbits) を検索します。
search_iftypes - ゲームの UI で使用されるインターフェース定義を iftypes.txt ファイルで検索します。
search_invtypes - ゲーム内のインベントリタイプの定義をinvtypes.txtファイルで検索します
search_loctypes - ゲームワールド内の場所/オブジェクトタイプの定義をloctypes.txtファイルで検索します
search_npctypes - npctypes.txt ファイルで NPC (非プレイヤーキャラクター) の定義を検索します
search_objtypes - ゲーム内のオブジェクト/アイテムの定義をobjtypes.txtファイルで検索します。
search_rowtypes - さまざまなインターフェースで使用される行定義を rowtypes.txt ファイルで検索します。
search_seqtypes - seqtypes.txt ファイルでアニメーションシーケンスの定義を検索します。
search_soundtypes - ゲーム内のサウンド効果の定義をsoundtypes.txtファイルで検索します
search_spottypes - spottypes.txt ファイルでスポットアニメーション (グラフィック効果) の定義を検索します
search_spritetypes - インターフェースで使用されるスプライト画像の定義をspritetypes.txtファイルで検索します。
search_tabletypes - インターフェースタブの定義をtabletypes.txtファイルで検索します

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

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

インストール

Smithery経由でインストール

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

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", {});

発達

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

OSRS MCP Server