English Français العربية

io.github.kcw2034/maplestory-mcp-server

Registre officiel Outils de développement

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

Code source Documentation

Que pouvez-vous faire avec 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.kcw2034/maplestory-mcp-server ?

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

Comment installer io.github.kcw2034/maplestory-mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add maplestory-mcp-server -e 'MAPLESTORY_API_KEY=<your maplestory_api_key>' -- uvx maplestory-mcp-server==1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.kcw2034/maplestory-mcp-server ?

Oui. Il attend MAPLESTORY_API_KEY, à renseigner dans sa configuration.

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

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.kcw2034/maplestory-mcp-server ?

Il est publié par kcw2034. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.