English Français العربية

io.github.kcw2034/maplestory-mcp-server

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • MAPLESTORY_API_KEY إلزامي سري API key from Nexon OpenAPI (https://open.api.nexon.com)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.kcw2034/maplestory-mcp-server؟

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

كيف أثبّت io.github.kcw2034/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.kcw2034/maplestory-mcp-server إلى مفتاح API؟

نعم. يتطلب MAPLESTORY_API_KEY، وتضبطها في إعداداته.

هل io.github.kcw2034/maplestory-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.kcw2034/maplestory-mcp-server؟

ينشره kcw2034. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.