maplestory-mcp-server

MapleStory MCP サーバー

Nexon MapleStory OpenAPI をラップする MCP（Model Context Protocol）サーバーです。AI アシスタントから、キャラクター情報、ランキング、ユニオン、ギルドなどの MapleStory のゲームデータを照会できます。

機能

• キャラクター - 基本情報、ステータス、装備、スキル、V/HEXA マトリックス、武陵道場の記録
• ユニオン - ユニオンレベル、レイダー配置、アーティファクト情報
• ギルド - ギルド検索と基本情報
• ランキング - 総合、ユニオン、ギルド、武陵道場、ザ・シード、実績のランキング
• 履歴 - スターフォース、キューブ、潜在能力の再設定履歴
• お知らせ - 公式のお知らせ、アップデート、イベント、キャッシュショップのお知らせ

前提条件

• 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	公式のお知らせ一覧

30 以上のツールの全リストについては、server.py を参照してください。

ライセンス

MIT