# PVZ Fusion MCP Server

> PVZ Fusion: Play, Wiki & Verified Build Guide

[![MCP Badge](https://lobehub.com/badge/mcp/rocnubie-pvz-fusion-mcp)](https://lobehub.com/mcp/rocnubie-pvz-fusion-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Stdio Transport](https://img.shields.io/badge/transport-stdio-6e6e6e)](https://modelcontextprotocol.io/specification)
[![Read Only](https://img.shields.io/badge/server-read--only-2ea44f)](#tools)
[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)

A Model Context Protocol server that exposes the canonical PVZ Fusion knowledge surface — game rules, modes, constraints, and entry points, 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://pvz-fusion.online

## 🎮 About PVZ Fusion

PVZ Fusion is an independent fan-made resource for exploring the game's gameplay, selected plant guides, and verified PC or Android build information. It is intended to help visitors understand the public resource and find the relevant live page before downloading anything.

The guide is a static site without a public API or database-backed service. This MCP exposes its documented rules, entry points, and source boundaries as read-only context; it does not run the game, host a build, or guarantee that a third-party download is safe or current.

PVZ Fusion is not an official PopCap, EA, or Plants vs. Zombies product. Use the live site, its source notes, and the applicable rights and download terms when following a link.

## Tools

### `get_game_rules`
Return the verified game rules, modes, constraints, and public entry points the site exposes. (PVZ Fusion)

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

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

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

## Resources

- `site://pvz-fusion/rules` — Verified game rules, modes, constraints, and public entry points.
- `site://pvz-fusion/faq` — Short FAQ generated from public site metadata.
- `site://pvz-fusion/links` — Canonical URLs to share with users.

## Prompts

### `tell_me_about_pvz_fusion`
Summarize what the site is, who it's for, and how it works. — PVZ Fusion

### `plan_a_run_pvz_fusion`
Plan a single play-through using verified rules and entry points. — PVZ Fusion

## Installation

### Install via Smithery

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

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

### Install from source

```bash
git clone https://github.com/rocnubie/pvz-fusion-mcp.git
cd pvz-fusion-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": {
    "pvz-fusion-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/pvz-fusion-mcp/src/index.mjs"
      ]
    }
  }
}
```

### Debug with MCP Inspector

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

## Official Links

- Website: https://pvz-fusion.online

## Development

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

## License

MIT