MCP Server Runescape

🚀 mcp-server-runescape Server

This is an experimental project that may have bugs or deficiencies. Feel free to submit issues or pull requests.

🚀 Quick Start

This project is an experimental one, and it might have bugs or deficiencies. You're welcome to submit issues or pull requests.

✨ Features

• Item Details: Retrieve detailed information corresponding to an item ID.
• Price Trends: Query historical price data for an item ID.
• Player Achievements: Get player achievements and level information.
• Trading Market: View the latest transaction records of items in the trading market.
• Game Status: Obtain the status information of the game server.

📦 Installation

Install from Source Code

Prerequisite: Make sure Node.js is installed on your system.

1. Clone this repository.
2. Install dependencies:

   yarn
   

   Or

   npm install
   

3. Update your Claude Desktop or Cursor configuration file to:

   {
     "mcpServers": {
       "mcp-server-runescape": {
         "command": "node",
         "args": ["/Users/path/to/mcp-server-runescape/src/server.js"]
       }
     }
   }
   

4. Optional: Run in debug mode

   yarn dev
   

   Or

   npm run build
   

⚠️ Important Note

Please replace /path/to/mcp-server-runescape with the actual path.

💻 Usage Examples

Configuration File Location

• Claude Desktop:

  ~/Library/Application Support/Claude/claude_desktop_config.json

• Cursor:

  /Users/name/.cursor/mcp.json

Basic Usage

Query Item Details

{
  "command": "mcp-server-runescape",
  "args": ["item", "318"],
  "options": {
    "itemId": 318
  }
}

Get Price History

{
  "command": "mcp-server-runescape",
  "args": ["price-history", "318"],
  "options": {
    "itemId": 318
  }
}

📚 Documentation

For more detailed information about the RuneScape API, please refer to:

RS/Wiki API

📄 Acknowledgments

I built this project during my weekends to learn about MCP servers. RuneScape turned out to be an ideal subject for practice.

• Special thanks to the RS Wiki team for providing documentation and APIs.

If you find this project helpful, you can support it in the following way: