{"id":"5a8a32d9-79e3-4272-a70c-608f10ef033f","slug":"maplestory-mcp-server","kind":"mcp","name":"maplestory-mcp-server","summary":"MCP server for MapleStory OpenAPI - query character info, rankings, union, guild and more","owner":"kcw2034","repoUrl":"https://github.com/kcw2034/maplestory-mcp-server","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-03-26T07:58:55.000Z","addedAt":"2026-10-14T05:41:12.854Z","logoUrl":"https://avatars.githubusercontent.com/u/178774345?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","developer-tools"],"tags":[],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":true,"reviewed":false,"syncedAt":"2026-10-17T16:25:57.552Z","sample":false,"url":"https://conduits.dev/tools/maplestory-mcp-server","language":"Python","transports":["stdio"],"install":{"pypi":"maplestory-mcp-server"},"requirements":{"env":[{"name":"MAPLESTORY_API_KEY","secret":true,"required":true,"description":"API key from Nexon OpenAPI (https://open.api.nexon.com)"}],"upstreamMayCharge":false},"tools":null,"readme":"# MapleStory MCP Server\n\nAn MCP (Model Context Protocol) server that wraps the [Nexon MapleStory OpenAPI](https://open.api.nexon.com), allowing AI assistants to query MapleStory game data including character info, rankings, union, guild, and more.\n\n## Features\n\n- **Character** - Basic info, stats, equipment, skills, V/HEXA matrix, Dojang records\n- **Union** - Union level, raider layout, artifact info\n- **Guild** - Guild search and basic info\n- **Ranking** - Overall, union, guild, Dojang, The Seed, achievement rankings\n- **History** - Starforce, cube, potential re-roll history\n- **Notice** - Official notices, updates, events, cash shop notices\n\n## Prerequisites\n\n- Python 3.13+\n- [uv](https://docs.astral.sh/uv/) package manager\n- MapleStory API key from [Nexon OpenAPI](https://open.api.nexon.com)\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/kcw2034/maplestory-mcp-server.git\ncd maplestory-mcp-server\n\n# Install dependencies\nuv sync\n```\n\n## Configuration\n\nCreate a `.env` file in the project root:\n\n```env\nMAPLESTORY_API_KEY=your_api_key_here\n```\n\nYou can get an API key by registering an app at [Nexon OpenAPI](https://open.api.nexon.com).\n\n## Usage\n\n### Running the server\n\n```bash\nuv run server.py\n```\n\n### Claude Desktop configuration\n\nAdd this to your Claude Desktop config (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"maplestory\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"server.py\"],\n      \"cwd\": \"/path/to/maplestory-mcp-server\",\n      \"env\": {\n        \"MAPLESTORY_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| Character | `get_character_ocid` | Look up character OCID by name |\n| Character | `get_character_basic` | Basic info (level, class, world, guild) |\n| Character | `get_character_stat` | Combined stats (STR, DEX, combat power) |\n| Character | `get_character_item_equipment` | Equipped items |\n| Character | `get_character_skill` | Skill info by grade |\n| Character | `get_character_hexamatrix` | HEXA matrix (6th job skills) |\n| Union | `get_union` | Union level and grade |\n| Union | `get_union_raider` | Union raider layout and effects |\n| Guild | `get_guild_id` | Look up guild ID by name and world |\n| Guild | `get_guild_basic` | Guild basic info |\n| Ranking | `get_ranking_overall` | Overall ranking |\n| Ranking | `get_ranking_dojang` | Mu Lung Dojang ranking |\n| History | `get_history_starforce` | Starforce enhancement history |\n| Notice | `get_notices` | Official notice list |\n\n> See `server.py` for the full list of 30+ tools.\n\n## License\n\n[MIT](LICENSE)\n\n<!-- mcp-name: io.github.kcw2034/maplestory-mcp-server -->\n"}