バージョン: 1.1.0

概要

WzImg MCP Server は、AI エージェントがプログラム的に MapleStory IMG ファイルとやり取りできるようにするモデルコンテキストプロトコル (MCP) サーバーです。 ゲームデータの読み込み、分析、変更、およびエクスポートの10カテゴリにわたって74ツールを提供します。

まず、.wzファイルをHaCreatorで.imgにエクスポートし、manifest.jsonが必要になります!

抽出 .wz ウィンドウ

お問い合わせ

クイックスタート

インストール

お問い合わせ

接続方法

WzImg MCPの特長 Server は 2 つのトランスポート モードをサポートしています。stdio (標準入出力) およびHTTP (SSE で処理可能な HTTP)。

MCP サーバー名: wzimg

メソッド1: Stdio (デフォルト)

stdioメソッドはサーバーをサブプロセスとして実行します。 クライアントは、stdin/stdout を介して通信します。

Claudeデスクトップの構成 ([%APPDATA%\Claude\claude_desktop_config.json])):

ロードコードの構成([.mcp.json])のプロジェクトルート:

Codex Configuration ([~/.codex/config.toml) または project-scoped [.codex/config.toml]]):

Codex は、CLI および IDE 拡張の MCP サーバーをサポートしています。 どちらのクライアントも config.toml を共有しているので、サーバーを一度設定する必要があります。 完全な構成リファレンスのCodex MCPのドキュメントを参照してください.

WzImg MCP Server Documentation

Version: 1.1.0

Overview

WzImg MCP Server is a Model Context Protocol (MCP) server that enables AI agents to interact with MapleStory IMG files programmatically. It provides 74 tools across 10 categories for reading, analyzing, modifying, and exporting game data.

First export the .wz files into .img with HaCreator, you will need the manifest.json!

---

Quick Start

Installation

# Build the server
cd WzImg-MCP-Server
dotnet build WzImgMCP.csproj

---

Connection Methods

WzImg MCP Server supports two transport modes: stdio (standard input/output) and HTTP (Streamable HTTP with SSE).

MCP server name: wzimg

Method 1: Stdio (Default)

The stdio method runs the server as a subprocess. The client communicates via stdin/stdout.

# Run in stdio mode (default)
dotnet run --project WzImgMCP

Claude Desktop Configuration (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "wzimg": {
      "command": "dotnet",
      "args": ["run", "--project", "E:/path/to/WzImg-MCP-Server/WzImgMCP.csproj"],
      "env": {
        "WZIMGMCP_DATA_PATH": "D:\\Extract\\v83"
      }
    }
  }
}

Claude Code Configuration (.mcp.json in project root):

{
  "mcpServers": {
    "wzimg": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "E:/path/to/WzImg-MCP-Server/WzImgMCP.csproj"],
      "env": {
        "WZIMGMCP_DATA_PATH": "D:\\Extract\\v83"
      }
    }
  }
}

Codex Configuration (~/.codex/config.toml or project-scoped .codex/config.toml):

Codex supports MCP servers in the CLI and IDE extension. Both clients share config.toml, so you only need to configure the server once. See the Codex MCP documentation for the full configuration reference.

[mcp_servers.wzimg]
command = "dotnet"
args = ["run", "--project", "E:/path/to/WzImg-MCP-Server/WzImgMCP.csproj"]

[mcp_servers.wzimg.env]
WZIMGMCP_DATA_PATH = "D:\\Extract\\v83"

You can also add the stdio server from the Codex CLI:

codex mcp add wzimg --env WZIMGMCP_DATA_PATH=D:/Extract/v83 -- dotnet run --project E:/path/to/WzImg-MCP-Server/WzImgMCP.csproj

In the Codex TUI, run /mcp to confirm that wzimg is available.

---

Method 2: HTTP (Streamable HTTP)

The HTTP method runs the server as a standalone web service. Clients connect via HTTP requests with Server-Sent Events (SSE) for streaming responses.

# Run in HTTP mode
dotnet run --project WzImgMCP -- --http

# Or specify a custom port
dotnet run --project WzImgMCP -- --http --port 8080

Claude Code Configuration (.mcp.json):

{