OSRS MCP 서버

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

도구

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

OSRS 위키 방법

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 - varps의 개별 비트를 저장하는 가변 비트(varbits)를 varbittypes.txt 파일에서 검색합니다.
search_iftypes - 게임 UI에 사용되는 인터페이스 정의를 iftypes.txt 파일에서 검색합니다.
search_invtypes - 게임의 인벤토리 유형 정의를 invtypes.txt 파일에서 검색합니다.
search_loctypes - 게임 세계의 위치/객체 유형 정의를 loctypes.txt 파일에서 검색합니다.
search_npctypes - NPC(비플레이어 캐릭터) 정의를 위해 npctypes.txt 파일을 검색합니다.
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를 자동으로 설치하려면:

지엑스피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 파일을 참조하세요.

OSRS MCP Server