English Français العربية

io.github.kcw2034/maplestory-mcp-server

Official registry Developer tools

MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices

Source code Documentation

What can you do with io.github.kcw2034/maplestory-mcp-server?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package maplestory-mcp-server
Claude Code 
claude mcp add maplestory-mcp-server -e 'MAPLESTORY_API_KEY=<your maplestory_api_key>' -- uvx maplestory-mcp-server==1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "maplestory-mcp-server": {
            "command": "uvx",
            "args": [
                "maplestory-mcp-server==1.0.1"
            ],
            "env": {
                "MAPLESTORY_API_KEY": "<your maplestory_api_key>"
            }
        }
    }
}

Environment variables

  • MAPLESTORY_API_KEY required secret API key from Nexon OpenAPI (https://open.api.nexon.com)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MapleStory MCP Server
  2. Features
  3. Prerequisites
  4. Installation
  5. Configuration
  6. Usage
  7. Available Tools
  8. License

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

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

CategoryToolDescription
Characterget_character_ocidLook up character OCID by name
Characterget_character_basicBasic info (level, class, world, guild)
Characterget_character_statCombined stats (STR, DEX, combat power)
Characterget_character_item_equipmentEquipped items
Characterget_character_skillSkill info by grade
Characterget_character_hexamatrixHEXA matrix (6th job skills)
Unionget_unionUnion level and grade
Unionget_union_raiderUnion raider layout and effects
Guildget_guild_idLook up guild ID by name and world
Guildget_guild_basicGuild basic info
Rankingget_ranking_overallOverall ranking
Rankingget_ranking_dojangMu Lung Dojang ranking
Historyget_history_starforceStarforce enhancement history
Noticeget_noticesOfficial notice list

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

License

MIT

Frequently asked questions

What is io.github.kcw2034/maplestory-mcp-server?

MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices

How do I install io.github.kcw2034/maplestory-mcp-server?

It runs on your machine. In Claude Code: claude mcp add maplestory-mcp-server -e 'MAPLESTORY_API_KEY=<your maplestory_api_key>' -- uvx maplestory-mcp-server==1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.kcw2034/maplestory-mcp-server need an API key?

Yes. It expects MAPLESTORY_API_KEY, which you set in its configuration.

Is io.github.kcw2034/maplestory-mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.kcw2034/maplestory-mcp-server?

It is published by kcw2034. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.