Maplestory Mcp Server

io.github.kcw2034Published by GitHub account kcw2034v1.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyLocation & LifestyleData & Analytics

Overview

AI-generated overview

Local MCP server that wraps the Nexon MapleStory OpenAPI, letting an assistant look up characters, unions, guilds, rankings, enhancement history and notices.

What you can do
Look up characters by name and fetch basic info, stats, equipped items, skills, HEXA matrix and Dojang records, plus starforce, cube and potential re-roll history. Retrieve union level, raider layout and artifact info. Search guilds by name and world and read guild basic info. Query overall, union, guild, Dojang, The Seed and achievement rankings. Read official notices, updates, events and cash shop notices.
When to use it
Useful when you want an assistant to answer questions about MapleStory characters, gear, unions, guilds, rankings or game news without leaving the chat, for example comparing builds or checking a character's enhancement history.
Requirements
Runs locally over stdio as a Python package (maplestory-mcp-server) with Python 3.13+ and the uv package manager. Requires a Nexon OpenAPI key supplied through the MAPLESTORY_API_KEY environment variable, obtained by registering an app at Nexon OpenAPI. Needs network access to the Nexon API. Desktop only.
Before you install
The MAPLESTORY_API_KEY secret is passed to the server and used against Nexon's API; keep it out of shared configs and repositories. Queries and character names are sent to Nexon's third-party service. The tools listed are read-only lookups, but the README notes 30+ tools, so check the full list before relying on it.

Installation

In SourceWeft

  1. Open Maplestory Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
# Clone the repositorygit clone https://github.com/kcw2034/maplestory-mcp-server.gitcd maplestory-mcp-server
# Install dependenciesuv sync

Configuration

Create a .env file in the project root:

env
MAPLESTORY_API_KEY=your_api_key_here

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

Usage

Running the server

bash
uv run server.py

Claude Desktop configuration

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

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

Source: README.md at commit bb2953f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts