{
  "markdown": "# 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",
  "bytes": 2712,
  "sha": "c304bd318ed79d7cefaef979ee86ff2bc7c62cd79cd533a07b20f2c6eabe837f",
  "repo_slug": "kcw2034/maplestory-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kcw2034_maplestory_mcp_server_c5d17c22/readme"
}