MCPgee
MCPgee
MCPgeeMCPgee

WzImg

v1.0.0•File Systems•stable

Enabling AI assistants to interact with MapleStory .IMG files - 74 tools for reading, analyzing, modifying, and exporting game data

wzimg-mcp-servermcpai-integration
Share:
14
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is WzImg?

WzImg is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enabling ai assistants to interact with maplestory .img files - 74 tools for reading, analyzing, modifying, and exporting game data

Enabling AI assistants to interact with MapleStory .IMG files - 74 tools for reading, analyzing, modifying, and exporting game data

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enabling AI assistants to interact with MapleStory .IMG file

Use Cases

Read and analyze MapleStory game image files with AI assistance.
Extract and modify game data from .IMG format files.
lastbattle

Maintainer

LicenseMIT
Languagec#
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx wzimg-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use WzImg

WzImg MCP Server is a C#/.NET MCP server that enables AI assistants such as Claude, GPT, and Gemini to interact programmatically with MapleStory .IMG files extracted from .wz archives. It provides 74 tools across 10 categories for reading, analyzing, modifying, and exporting game data including sprites, sounds, strings, and node structures. Game modders, data miners, and tooling developers working with MapleStory assets can use it to query and transform game content through natural language.

Prerequisites

  • .NET SDK 8.0 or higher installed
  • HaCreator (Harepacker-resurrected) to extract .wz files into .img format — the extracted directory must contain a manifest.json file
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • The WzImg-MCP-Server repository cloned locally
1

Extract .wz files to .img format

Use HaCreator (Harepacker-resurrected) to extract your MapleStory .wz files into .img files. The extraction output directory must contain a manifest.json file, which the server requires to locate assets.

2

Clone and build the server

Clone the WzImg-MCP-Server repository and build the .NET project using the dotnet CLI.

git clone https://github.com/lastbattle/WzImg-MCP-Server.git
cd WzImg-MCP-Server
dotnet build WzImgMCP.csproj
3

Set the data path environment variable

Set WZIMGMCP_DATA_PATH to the directory containing your extracted .img files and manifest.json. This tells the server where to load game data from.

# Linux/macOS
export WZIMGMCP_DATA_PATH=/path/to/extracted/v83

# Windows PowerShell
$env:WZIMGMCP_DATA_PATH="D:\Extract\v83"
4

Configure Claude Desktop for stdio mode

Add the server to claude_desktop_config.json using dotnet run as the command, with the project path and data path environment variable.

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

Alternatively run in HTTP mode for multiple clients

Start the server in HTTP mode with Streamable HTTP transport so multiple clients can connect simultaneously. The default port is 13339.

WZIMGMCP_DATA_PATH=/path/to/v83 dotnet run --project WzImgMCP -- --http --port 8080

WzImg Examples

Client configuration

Claude Desktop configuration for WzImg MCP Server using stdio transport with the extracted MapleStory data directory.

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

Prompts to try

Example prompts for exploring and modifying MapleStory .IMG file data through the AI assistant.

- "List all categories of IMG files available in the current data set"
- "Show me the node structure of the Character/00002000.img file"
- "Extract all string values from the String/Mob.img file"
- "Find all bitmap images in the UI directory"
- "Export the sound data from Sound/Bgm00.img to JSON format"

Troubleshooting WzImg

Server fails to start with 'manifest.json not found' error

Ensure WZIMGMCP_DATA_PATH points to the directory produced by HaCreator that contains manifest.json. The file must be at the root of the data path, not in a subdirectory.

dotnet build fails due to missing SDK or project file

Install .NET SDK 8.0 or higher from dotnet.microsoft.com. Verify with 'dotnet --version'. Use the full absolute path to WzImgMCP.csproj in the build command.

Claude Desktop cannot connect when using HTTP mode

When using HTTP transport, configure the MCP client with the HTTP URL (e.g. http://127.0.0.1:13339/mcp) instead of a command/args block. Set WZIMGMCP_DATA_PATH before starting the server process, not in the client config.

Frequently Asked Questions about WzImg

What is WzImg?

WzImg is a Model Context Protocol (MCP) server that enabling ai assistants to interact with maplestory .img files - 74 tools for reading, analyzing, modifying, and exporting game data It connects AI assistants to external tools and data sources through a standardized interface.

How do I install WzImg?

Follow the installation instructions on the WzImg GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with WzImg?

WzImg works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is WzImg free to use?

Yes, WzImg is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

WzImg Alternatives — Similar File Systems Servers

Looking for alternatives to WzImg? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File SystemsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "wzimg-mcp-server": { "command": "npx", "args": ["-y", "wzimg-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use WzImg?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides