MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"maplestory": {
"cwd": "/path/to/maplestory-mcp-server",
"env": {
"MAPLESTORY_API_KEY": "your_api_key_here"
},
"args": [
"run",
"server.py"
],
"command": "uv"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationBe the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in entertainment
The official MCP Server for the Mux API
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Unity MCP Server — 268 tools for AI-assisted game development. Connect Claude, Cursor, or any MCP client to Unity Editor & Unity Hub. Scene management, GameObjects, components, builds, profiling, Shader Graph, Amplify, terrain, physics, NavMesh, animation, MPPM multiplayer & more. Free & open source by AnkleBreaker Studio.
A Model Context Protocol (MCP) server that gives Claude direct control over Strudel.cc for AI-assisted music generation and live coding.
MCP Security Weekly
Get CVE alerts and security updates for io.github.kcw2034/maplestory-mcp-server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
# Clone the repository
git clone https://github.com/kcw2034/maplestory-mcp-server.git
cd maplestory-mcp-server
# Install dependencies
uv sync
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.
uv run server.py
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"
}
}
}
}
| 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.