MapleStory MCP Server

An MCP (Model Context Protocol) server that wraps the Nexon MapleStory OpenAPI, allowing AI assistants to query MapleStory game data including character info, rankings, union, guild, and more.

Features

• Character - Basic info, stats, equipment, skills, V/HEXA matrix, Dojang records
• Union - Union level, raider layout, artifact info
• Guild - Guild search and basic info
• Ranking - Overall, union, guild, Dojang, The Seed, achievement rankings
• History - Starforce, cube, potential re-roll history
• Notice - Official notices, updates, events, cash shop notices

Prerequisites

• Python 3.13+
• uv package manager
• MapleStory API key from Nexon OpenAPI

Installation

# Clone the repository
git clone https://github.com/kcw2034/maplestory-mcp-server.git
cd maplestory-mcp-server

# Install dependencies
uv sync

Configuration

Create a .env file in the project root:

MAPLESTORY_API_KEY=your_api_key_here

You can get an API key by registering an app at Nexon OpenAPI.

Usage

Running the server

uv run server.py

Claude Desktop configuration

Add this to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "maplestory": {
      "command": "uv",
      "args": ["run", "server.py"],
      "cwd": "/path/to/maplestory-mcp-server",
      "env": {
        "MAPLESTORY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

See server.py for the full list of 30+ tools.

License

MIT