Server data from the Official MCP Registry
MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices
About
MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices
Security Report
Valid MCP server (0 strong, 3 medium validity signals). 3 known CVEs in dependencies (1 critical, 1 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
3 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: MAPLESTORY_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-kcw2034-maplestory-mcp-server": {
"env": {
"MAPLESTORY_API_KEY": "your-maplestory-api-key-here"
},
"args": [
"maplestory-mcp-server"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
- 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
| Category | Tool | Description |
|---|---|---|
| Character | get_character_ocid | Look up character OCID by name |
| Character | get_character_basic | Basic info (level, class, world, guild) |
| Character | get_character_stat | Combined stats (STR, DEX, combat power) |
| Character | get_character_item_equipment | Equipped items |
| Character | get_character_skill | Skill info by grade |
| Character | get_character_hexamatrix | HEXA matrix (6th job skills) |
| Union | get_union | Union level and grade |
| Union | get_union_raider | Union raider layout and effects |
| Guild | get_guild_id | Look up guild ID by name and world |
| Guild | get_guild_basic | Guild basic info |
| Ranking | get_ranking_overall | Overall ranking |
| Ranking | get_ranking_dojang | Mu Lung Dojang ranking |
| History | get_history_starforce | Starforce enhancement history |
| Notice | get_notices | Official notice list |
See
server.pyfor the full list of 30+ tools.
License
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.