Skip to main content
Glama

OSRS MCP 서버 대장간 배지

Old School RuneScape(OSRS) 위키 API 및 데이터 파일과 상호 작용하는 MCP 서버입니다. 이 서버는 OSRS 위키를 검색하고 모델 컨텍스트 프로토콜을 통해 게임 데이터 정의에 접근할 수 있는 도구를 제공합니다.

영상

영상

영상

도구

이 서버는 다음 도구를 구현합니다.

OSRS 위키 방법

  1. osrs_wiki_search - 검색어와 일치하는 페이지를 OSRS Wiki에서 검색합니다.

  2. osrs_wiki_get_page_info - OSRS Wiki의 특정 페이지에 대한 정보를 가져옵니다.

  3. osrs_wiki_parse_page - 특정 OSRS Wiki 페이지의 구문 분석된 HTML 콘텐츠를 가져옵니다.

게임 데이터 검색 방법

  1. search_varptypes - 플레이어 상태 및 진행 상황을 저장하는 플레이어 변수(varp)를 varptypes.txt 파일에서 검색합니다.

  2. search_varbittypes - varps의 개별 비트를 저장하는 가변 비트(varbits)를 varbittypes.txt 파일에서 검색합니다.

  3. search_iftypes - 게임 UI에 사용되는 인터페이스 정의를 iftypes.txt 파일에서 검색합니다.

  4. search_invtypes - 게임의 인벤토리 유형 정의를 invtypes.txt 파일에서 검색합니다.

  5. search_loctypes - 게임 세계의 위치/객체 유형 정의를 loctypes.txt 파일에서 검색합니다.

  6. search_npctypes - NPC(비플레이어 캐릭터) 정의를 위해 npctypes.txt 파일을 검색합니다.

  7. search_objtypes - 게임의 객체/아이템 정의를 objtypes.txt 파일에서 검색합니다.

  8. search_rowtypes - 다양한 인터페이스에서 사용되는 행 정의를 rowtypes.txt 파일에서 검색합니다.

  9. search_seqtypes - seqtypes.txt 파일에서 애니메이션 시퀀스 정의를 검색합니다.

  10. search_soundtypes - 게임의 사운드 효과 정의를 soundtypes.txt 파일에서 검색합니다.

  11. search_spottypes - spottypes.txt 파일에서 스팟 애니메이션(그래픽 효과) 정의를 검색합니다.

  12. search_spritetypes - 인터페이스에서 사용되는 스프라이트 이미지 정의를 spritetypes.txt 파일에서 검색합니다.

  13. search_tabletypes - 인터페이스 탭 정의를 위해 tabletypes.txt 파일을 검색합니다.

일반 데이터 파일 방법

  1. search_data_file - 데이터 디렉토리에서 일치하는 항목을 검색합니다.

  2. get_file_details - 데이터 디렉토리에 있는 파일에 대한 세부 정보를 가져옵니다.

  3. list_data_files - 데이터 디렉토리에서 사용 가능한 데이터 파일을 나열합니다.

Related MCP server: Wiki OSRS MCP

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 mcp-osrs를 자동으로 설치하려면:

지엑스피1

필수 조건

  • 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 위키 검색

// 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 파일을 참조하세요.

Available Tools

23 tools
get_file_detailsC

Get details about a file in the data directory.

Inputs: filename (required).

get_ge_latestA

Get the latest Grand Exchange high and low prices for a specific item by its ID.

Inputs: itemId (required).

get_ge_timeseriesA

Get historical time-series price data for an item at a given interval (5m, 1h, 6h, 24h). Returns up to 365 data points.

Inputs: itemId (required), timestep (required).

list_data_filesB

List available data files in the data directory.

Inputs: fileType.

lookup_playerA

Look up an OSRS player's stats (skills, bosses, clue scrolls, and activities) from the official hiscores.

Inputs: playerName (required), gamemode.

osrs_wiki_get_page_infoC

Get information about specific pages on the OSRS Wiki.

Inputs: titles (required).

osrs_wiki_parse_pageC

Get the parsed HTML content of a specific OSRS Wiki page.

Inputs: page (required).

search_data_fileC

Search any file in the data directory for matching entries.

Inputs: filename (required), query (required), page, pageSize.

search_ge_itemsA

Search for Grand Exchange tradeable items by name. Uses an exact/prefix/substring match. Returns item IDs, names, buy limits, and alch values.

Inputs: query (required), page, pageSize.

search_iftypesC

Search the iftypes.txt file for interface definitions used in the game's UI.

Inputs: query (required), page, pageSize.

search_invtypesC

Search the invtypes.txt file for inventory type definitions in the game.

Inputs: query (required), page, pageSize.

search_loctypesC

Search the loctypes.txt file for location/object type definitions in the game world.

Inputs: query (required), page, pageSize.

search_npctypesC

Search the npctypes.txt file for NPC (non-player character) definitions.

Inputs: query (required), page, pageSize.

search_objtypesC

Search the objtypes.txt file for object/item definitions in the game.

Inputs: query (required), page, pageSize.

search_rowtypesC

Search the rowtypes.txt file for row definitions used in various interfaces.

Inputs: query (required), page, pageSize.

search_seqtypesC

Search the seqtypes.txt file for animation sequence definitions.

Inputs: query (required), page, pageSize.

search_soundtypesC

Search the soundtypes.txt file for sound effect definitions in the game.

Inputs: query (required), page, pageSize.

search_spottypesC

Search the spottypes.txt file for spot animation (graphical effect) definitions.

Inputs: query (required), page, pageSize.

search_spritetypesC

Search the spritetypes.txt file for sprite image definitions used in the interface.

Inputs: query (required), page, pageSize.

search_tabletypesC

Search the tabletypes.txt file for interface tab definitions.

Inputs: query (required), page, pageSize.

search_varbittypesC

Search the varbittypes.txt file for variable bits (varbits) that store individual bits from varps.

Inputs: query (required), page, pageSize.

search_varptypesC

Search the varptypes.txt file for player variables (varps) that store player state and progress.

Inputs: query (required), page, pageSize.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 23 tools

    Disambiguation3/5

    Many search_* tools are very similar in function, only differing by the file they search. While descriptions specify which file, an agent could easily confuse them, especially with many type definition tools.

    Naming Consistency4/5

    Tools consistently use snake_case and start with verbs like get, lookup, search, list. However, some tools use an 'osrs_wiki_' prefix while others do not, creating minor inconsistency.

    Tool Count4/5

    23 tools is slightly above the typical well-scoped range but is reasonable for a comprehensive OSRS server covering wiki, hiscores, GE, and many game definition searches.

    Completeness4/5

    Covers major areas like wiki, hiscores, GE, and extensive type definitions. Some gaps (e.g., quests, combat calculations) but overall a solid surface for OSRS tasks.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      Not graded
      maintenance
      MCP Server for interacting with Old School RuneScape Wiki API and game data files, providing tools to search the OSRS Wiki and access game data definitions through the Model Context Protocol.
      19
      50 npm
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      This server enables interaction with the Old School RuneScape (OSRS) Wiki API and provides access to extensive game data definitions for items, NPCs, and interfaces. It allows users to search the wiki and query underlying game files through the Model Context Protocol.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search the OSRS Wiki, lookup Grand Exchange prices, and access synced player data (bank, skills, quests, etc.) via local RuneLite plugin files.
      13
      1
      BSD 2-Clause "Simplified"