palsaveeditor-mcp

# Pal Save Editor MCP Server

> Palworld Save Editor Tool - Inspect Before Changes

[![MCP Badge](https://lobehub.com/badge/mcp/rocnubie-palsaveeditor-mcp)](https://lobehub.com/mcp/rocnubie-palsaveeditor-mcp)
[![Node](https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![Read Only](https://img.shields.io/badge/server-read--only-2ea44f)](#tools)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)
[![smithery](https://smithery.ai/badge/palsaveeditor)](https://smithery.ai)

A Model Context Protocol server that exposes the canonical Pal Save Editor knowledge surface — browser editing workflows, local processing, and safety boundaries, FAQ, official links — to MCP-compatible AI clients such as Claude Desktop, Cursor, Windsurf, and Continue. Read-only, no API keys, no quota, ~50 ms cold start.

Official website: https://palsaveeditor.com

## 🛠️ About Pal Save Editor

Pal Save Editor is a browser-only Palworld save safety workbench. It recognizes local save file sets, compares snapshots, creates a private recognition receipt, and exports a local safe pack while keeping file processing in a Web Worker.

The current release deliberately limits its scope: real Palworld binary mutation is locked, binary comparison is limited to paths, roles, sizes, signatures, and hashes, and field-level semantic diff is available only for documented JSON fixtures. PlM and Oodle files remain read-only, and the tool does not repair bytes or guarantee that Palworld will load an exported candidate.

This MCP exposes those capabilities and safety boundaries as read-only context. It does not receive save files, edit a user's world, or claim that an unsupported repair path exists.

## Tools

### `get_editor_scope`
Return the editor workflow and the documented limits on local processing or export. (Pal Save Editor)

_Input:_ no parameters. _Returns:_ text/markdown.

### `get_official_links`
Return the canonical list of official links for Pal Save Editor (website, support, docs when available).

_Input:_ no parameters. _Returns:_ text/markdown.

## Resources

- `site://palsaveeditor/workbench` — Public editing workflow, local-processing model, and documented safety limits.
- `site://palsaveeditor/faq` — Short FAQ generated from public site metadata.
- `site://palsaveeditor/links` — Canonical URLs to share with users.

## Prompts

### `tell_me_about_palsaveeditor`
Summarize what the site is, who it's for, and how it works. — Pal Save Editor

### `review_edit_scope_palsaveeditor`
Review an editing workflow without promising unsupported file mutation. — Pal Save Editor

## Installation

### Install via Smithery

```bash
npx -y @smithery/cli install palsaveeditor-mcp --client claude
```

(Replace `claude` with `cursor`, `windsurf`, or `continue` for those clients.)

### Install from source

```bash
git clone https://github.com/rocnubie/palsaveeditor-mcp.git
cd palsaveeditor-mcp
pnpm install
```

Then add to your MCP client config (`claude_desktop_config.json` for Claude Desktop, `mcp.json` for Cursor / Windsurf / Continue):

```json
{
  "mcpServers": {
    "palsaveeditor-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/palsaveeditor-mcp/src/index.mjs"
      ]
    }
  }
}
```

### Debug with MCP Inspector

```bash
npx @modelcontextprotocol/inspector node src/index.mjs
```

## Official Links

- Website: https://palsaveeditor.com

## Development

```bash
pnpm install
pnpm start                 # run the server over stdio
```

## License

MIT