logo
Login
Cover image
MCP-OSRS
Private

MCP-OSRS

Try Now
2025-04-14

MCP Server para AI para entender OSRS

3 years

Works with Finder

1

Github Watches

0

Github Forks

1

Github Stars

OSRS MCP Server smithery badge

MCP Server for interacting with the Old School RuneScape (OSRS) Wiki API and data files. This server provides tools to search the OSRS Wiki and access game data definitions through the Model Context Protocol.

image

image

image

Tools

This server implements the following tools:

OSRS Wiki Methods

  1. osrs_wiki_search - Search the OSRS Wiki for pages matching a search term
  2. osrs_wiki_get_page_info - Get information about specific pages on the OSRS Wiki
  3. osrs_wiki_parse_page - Get the parsed HTML content of a specific OSRS Wiki page

Game Data Search Methods

  1. search_varptypes - Search the varptypes.txt file for player variables (varps) that store player state and progress
  2. search_varbittypes - Search the varbittypes.txt file for variable bits (varbits) that store individual bits from varps
  3. search_iftypes - Search the iftypes.txt file for interface definitions used in the game's UI
  4. search_invtypes - Search the invtypes.txt file for inventory type definitions in the game
  5. search_loctypes - Search the loctypes.txt file for location/object type definitions in the game world
  6. search_npctypes - Search the npctypes.txt file for NPC (non-player character) definitions
  7. search_objtypes - Search the objtypes.txt file for object/item definitions in the game
  8. search_rowtypes - Search the rowtypes.txt file for row definitions used in various interfaces
  9. search_seqtypes - Search the seqtypes.txt file for animation sequence definitions
  10. search_soundtypes - Search the soundtypes.txt file for sound effect definitions in the game
  11. search_spottypes - Search the spottypes.txt file for spot animation (graphical effect) definitions
  12. search_spritetypes - Search the spritetypes.txt file for sprite image definitions used in the interface
  13. search_tabletypes - Search the tabletypes.txt file for interface tab definitions

Generic Data File Methods

  1. search_data_file - Search any file in the data directory for matching entries
  2. get_file_details - Get details about a file in the data directory
  3. list_data_files - List available data files in the data directory

Installation

Installing via Smithery

To install mcp-osrs for Claude Desktop automatically via Smithery:

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

Prerequisites

  • Node.js (v16 or later)
  • npm or yarn

Installing the package

# 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

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Using npx

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

Direct Node.js

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

Replace /path/to/mcp-osrs with the actual path to your repository.

Examples

Search the OSRS Wiki

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

Get Page Information

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

Search Game Data

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

List Available Data Files

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

Development

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

相关推荐

puerto

puerto

  • av

    • Ejecute sin esfuerzo LLM Backends, API, frontends y servicios con un solo comando.

    2 (1)
    impresionante-llm-recesses

    impresionante-llm-recesses

  • WangRongsheng

    • 🧑‍🚀 全世界最好的 llM 资料总结（数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型） | Resumen de los mejores recursos del mundo.

    3.5 (4)
    1 panel

    1 panel

  • 1Panel-dev

    • 🔥 1Panel proporciona una interfaz web intuitiva y un servidor MCP para administrar sitios web, archivos, contenedores, bases de datos y LLM en un servidor de Linux.

    2 (1)
    rulego

    rulego

  • rulego

    • ⛓️Rulego es un marco de motor de regla de orquestación de componentes de alta generación de alto rendimiento, de alto rendimiento y de alto rendimiento para GO.

    3.7 (10)
    Azure-MCP

    Azure-MCP

  • Azure

    • Este repositorio es para el desarrollo del servidor Azure MCP, llevando el poder de Azure a sus agentes.

    3 (5)
    agentes de MCP

    agentes de MCP

  • caio-moliveira

    • Este proyecto fue creado para demostrar cómo podemos conectarnos con diferentes protocolos de contexto del modelo (MCP).

    3.2 (5)
    MCP-moedas

    MCP-moedas

  • MarcusAdriano

    • Estudando MCP Usando una API do bacen ptax

    3.3 (4)

    Reviews

    2.9 (15)
    Avatar
    user_l46nrXbY
    2025-04-26

    I've been a loyal user of mcp-osrs by JayArrowz, and I must say it's an outstanding application! It has drastically improved my gameplay experience in OSRS, offering a seamless interface and robust features. Highly recommend it to any OSRS enthusiast looking to enhance their gameplay!

    Avatar
    user_SOsvUsRW
    2025-04-26

    As a dedicated user of MCP applications, I must say that the mcp-osrs by JayArrowz has significantly enhanced my overall experience. Its seamless integration and user-friendly interface make it a top-notch tool for any OSRS enthusiast. It's highly reliable and has never let me down. Highly recommended for anyone serious about optimizing their Old School RuneScape gameplay!

    Avatar
    user_CUGS5tp1
    2025-04-26

    As a devoted user of mcp-osrs, I can confidently say that JayArrowz has crafted an exceptional product. The precision and user-friendliness of mcp-osrs have significantly improved my overall experience. The interface is intuitive and the functionality is robust, making every session seamless. Highly recommend for anyone looking to enhance their OSRS adventures!

    Avatar
    user_11asDCNR
    2025-04-26

    I've been using mcp-osrs by JayArrowz, and it's been a game-changer for my Old School RuneScape experience. The interface is intuitive, and the tools provided have significantly improved my gameplay efficiency. Whether you're a casual player or a serious gamer, mcp-osrs is a must-have. Highly recommend!

    Avatar
    user_OLjSiQep
    2025-04-26

    As a dedicated user of mcp-osrs by JayArrowz, I must say this tool has significantly enhanced my RuneScape experience. Its seamless integration and intuitive design make it a must-have for any serious player. The constant updates and support are fantastic, always keeping the tool in top-notch condition. Highly recommend it!

    Avatar
    user_THqIoxeI
    2025-04-26

    As a dedicated user of mcp-osrs by JayArrowz, I must say this product has truly enhanced my experience. The seamless integration and user-friendly interface make it a joy to use. I highly recommend it to anyone looking to improve their workflow and efficiency. Kudos to the creator for such a fantastic tool!

    Avatar
    user_Ymxf79Aw
    2025-04-26

    As a dedicated user of mcp-osrs, I am thoroughly impressed by this application created by JayArrowz. It has seamlessly enhanced my OSRS experience by providing an intuitive and user-friendly interface. The features are well thought out and the performance is impeccable. Highly recommend this to any OSRS enthusiast looking to optimize their gameplay!

    Avatar
    user_jIFHXriT
    2025-04-26

    As a dedicated MCP application user, I must say mcp-osrs by JayArrowz is outstanding. It streamlines my tasks efficiently and the user interface is splendid. Highly recommend for anyone looking to enhance their productivity.

    Avatar
    user_sGbTEHtV
    2025-04-26

    I've been using mcp-osrs by JayArrowz for a while now, and it has completely transformed my experience. The interface is intuitive and easy to navigate. JayArrowz has done a fantastic job with this product. Highly recommend it to anyone!

    Avatar
    user_HwQjwHIi
    2025-04-26

    As a dedicated user of mcp-osrs by JayArrowz, I can confidently say that this product has significantly enhanced my overall experience. The seamless integration and user-friendly interface make it a must-have for anyone looking to optimize their gameplay. Highly recommend it for all enthusiasts!

    Avatar
    user_odBxrVVw
    2025-04-26

    I've been using mcp-osrs by JayArrowz and it's simply outstanding. The user-friendly interface and the seamless integration with OSRS have significantly enhanced my gameplay experience. It's a must-have tool for any serious OSRS player, making everything more efficient and enjoyable. Highly recommend it!

    Avatar
    user_k68OwHC6
    2025-04-26

    As a dedicated user of mcp-osrs by JayArrowz, I can confidently say that this application has greatly enhanced my gaming experience. The intuitive interface and seamless integration with the game make it a must-have for any RuneScape player. Its efficiency and ease of use really stand out, making my in-game activities much more enjoyable and productive. Highly recommended!

    Avatar
    user_ziQc8u5D
    2025-04-26

    I've been using the mcp-osrs application by JayArrowz and it has completely transformed my Old School RuneScape experience. The user-friendly interface and seamless integration make it an invaluable tool for both new and seasoned players. Highly recommended for anyone looking to enhance their gameplay!

    Avatar
    user_aJhPx9yi
    2025-04-26

    As an avid user of mcp-osrs, I must say it has transformed my OSRS experience. JayArrowz has done a splendid job developing this application. The interface is intuitive and the functionalities are seamless, which makes game management a breeze. Highly recommended for any OSRS enthusiast looking to enhance their gameplay!

    Avatar
    user_IAOu3lN5
    2025-04-26

    MCP-OSRS by JayArrowz is a game-changer for any Old School RuneScape enthusiast. Its seamless integration and user-friendly interface have significantly enhanced my gameplay experience. Highly recommend for both casual and hardcore players!