Версия: 1.1.0

Обзор

WzImg MCP Server - это сервер протокола Model Context Protocol (MCP), который позволяет агентам ИИ программно взаимодействовать с файлами MapleStory IMG. Он предоставляет 74 инструмента по 10 категориям для чтения, анализа, модификации и экспорта игровых данных.

Сначала экспортируйте файлы .wz в .img с помощью HaCreator, вам понадобится manifest.json!

Выдержка из окна .wz

Быстрый старт

###Установка

Методы подключения

WzImg MCP Сервер поддерживает два вида транспорта: stdio (стандартный ввод/вывод) и HTTP (Streamable HTTP with SSE).

Имя сервера MCP: wzimg

Метод 1: Stdio (по умолчанию)

Метод stdio запускает сервер как подпроцесс. Клиент общается через stdin/stdout.

Claude Desktop Configuration ([T0]):

Claude Code Configuration ([T1]) в корне проекта:

Кодексная конфигурация ([T2]) или проектная конфигурация .codex/config.toml:

Codex поддерживает MCP-серверы в расширениях CLI и IDE. Оба клиента разделяют 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):

{