maplestory-mcp-server

Name: maplestory-mcp-server
Author: kcw2034

本地服务

github.com/kcw2034游戏娱乐031 周前更新

代码仓库

关于 maplestory-mcp-server

这是 Nexon MapleStory OpenAPI 的封装，供 AI 助手查询角色、排名、联盟、公会、历史记录和公告，适合通过 MCP 客户端获取游戏信息的玩家。

主要功能

01角色属性与装备
02联盟和公会查询
03多类排行榜
04强化历史记录
05官方公告与活动

适用场景

01查看角色属性和装备
02比较排行榜名次
03查询联盟或公会详情
04查看强化历史与公告

MCP 相关

通过 MCP 工具提供 MapleStory 数据，包括角色、联盟、公会、排名、历史记录和公告查询。MCP 客户端可按文档配置运行该服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "kcw2034-maplestory": {
      "command": "uvx",
      "args": [
        "maplestory-mcp-server"
      ],
      "env": {
        "MAPLESTORY_API_KEY": "<MAPLESTORY_API_KEY>"
      }
    }
  }
}

启动命令uvx maplestory-mcp-server

需要配置的环境变量

MAPLESTORY_API_KEY密钥API key from Nexon OpenAPI (https://open.api.nexon.com)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimaplestory-mcp-server1.0.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
character_name	string	是	角色名称

详细介绍

MapleStory MCP 服务

一个 MCP（Model Context Protocol）服务，用于封装 Nexon MapleStory OpenAPI，让 AI 助手能够查询 MapleStory 游戏数据，包括角色信息、排名、联盟、公会等。

功能

角色 - 基本信息、属性、装备、技能、V/HEXA 矩阵、武陵道场记录
联盟 - 联盟等级、战队布局、神器信息
公会 - 公会搜索和基本信息
排名 - 综合、联盟、公会、武陵道场、The Seed、成就排名
历史记录 - 星力、方块、潜能重置记录
公告 - 官方公告、更新、活动、商城公告

前置条件

Python 3.13+
uv 包管理器
从 Nexon OpenAPI 获取的 MapleStory API 密钥

安装

# Clone the repository
git clone https://github.com/kcw2034/maplestory-mcp-server.git
cd maplestory-mcp-server

# Install dependencies
uv sync

配置

在项目根目录创建一个 .env 文件：

MAPLESTORY_API_KEY=your_api_key_here

你可以在 Nexon OpenAPI 注册应用以获取 API 密钥。

使用方法

运行服务

uv run server.py

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置文件（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"
      }
    }
  }
}

可用工具

类别	工具	描述
角色	`get_character_ocid`	根据名称查询角色 OCID
角色	`get_character_basic`	基本信息（等级、职业、世界、公会）
角色	`get_character_stat`	综合属性（STR、DEX、战斗力）
角色	`get_character_item_equipment`	已装备物品
角色	`get_character_skill`	按等级查询技能信息
角色	`get_character_hexamatrix`	HEXA 矩阵（6 转技能）
联盟	`get_union`	联盟等级和级别
联盟	`get_union_raider`	联盟战队布局和效果
公会	`get_guild_id`	根据名称和世界查询公会 ID
公会	`get_guild_basic`	公会基本信息
排名	`get_ranking_overall`	综合排名
排名	`get_ranking_dojang`	武陵道场排名
历史记录	`get_history_starforce`	星力强化记录
公告	`get_notices`	官方公告列表