** 버전**: 1.1.0

개요

WzImg MCP 서버는 MapleStory IMG 파일 프로그래밍과 상호 작용하는 AI 대리인을 가능하게 하는 모형 Context 의정서 (MCP) 서버입니다. 그것은 읽기, 분석, 수정, 내보내기 게임 데이터에 대한 10 가지 범주의 74 도구를 제공합니다.

.wz 파일을 HaCreator로 내보내기 위해 .img를 먼저 내보내면, prop.json이 필요합니다!

추출물 .wz 창

---

빠른 시작

설치

---

연결 방법

사이트맵 서버는 두 개의 전송 모드를 지원합니다: stdio (표준 입력/출력) 및 HTTP (SSE와 스트리밍 가능한 HTTP).

MCP 서버 이름: wzimg

메서드 1: Stdio (기본값)

stdio 메소드는 하위 프로세스로 서버를 실행합니다. 클라이언트는 stdin/stdout를 통해 교통합니다.

Claude 데스크탑 구성 (%APPDATA%\Claude\claude_desktop_config.json):

Claude Code Configuration (.mcp.json 프로젝트 루트):

** 코덱 구성** ([T2]] 또는 프로젝트스코프 .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):

{