Skip to content
Cec1cPublic

About

一个用于pvfUtility 的MCP服务 使用GO语言编写

Resources

Stars

19 stars

Watchers

1 watching

Forks

Repository files navigation

PVF-MCP

语言:Go 协议:MCP stdio 平台:Windows 10 / 11 发行版 Stars

在 pvfUtility 中打开 PVF,让 AI 帮你查找物品、读取脚本并修改游戏数据。

PVF-MCP 用 26 个工具连接编辑器和 AI 客户端。下载一个可执行文件,通过 stdio 接入即可使用。

English | 下载 | 快速开始 | 工具手册

Note

连接方式:AI 客户端通过 stdio 启动 PVF-MCP,再由 PVF-MCP 访问本机 pvfUtility 的 http://localhost:27000。客户端填写下方的可执行文件路径。

能做什么?

  • 找到需要的数据。 搜索物品、技能和 NPC,按物品代码查文件,读取 LST 索引与图标。
  • 按结构修改内容。 将 PVF 解析为 JSON 树,修改字段后转回原始文本,导入并保存。
  • 配合编辑器工作。 获取 pvfUtility 当前打开的文档和选中文件,让 AI 接着你正在看的内容处理。

连接完成后,可以先查一件物品:

找到 SP+20 技能书,列出文件路径、物品代码和当前价格,先不要修改。

快速开始

1. 准备 pvfUtility

在 Windows 10 / 11 上打开 pvfUtility(≥ 2022.9.30.2),加载一个 PVF 文件,并确认 HTTP API 可用。

2. 下载并接入 AI 客户端

从 最新 Release 下载 pvf-mcp.exe,放到固定目录,例如 C:\Tools\pvf-mcp\pvf-mcp.exe。使用发行包无需安装 Go、Python 或 Node.js。

Codex CLI 用户可运行以下命令,将路径替换为实际存放位置:

codex mcp add pvf-mcp -- "C:\Tools\pvf-mcp\pvf-mcp.exe"

其他客户端选择 stdio,将启动命令设为可执行文件的绝对路径,无需额外参数。

JSON 配置示例(支持 mcpServers 格式的客户端)

将此条目合并到客户端现有 MCP 配置中,并按该客户端的说明选择配置文件位置:

{
  "mcpServers": {
    "pvf-mcp": {
      "command": "C:\\Tools\\pvf-mcp\\pvf-mcp.exe"
    }
  }
}

3. 确认连接

重新加载 AI 客户端的 MCP 配置,依次调用 get_version 和 get_loaded_pvf_path,确认连接到预期的编辑器版本与 PVF 文件,再开始查询或编辑。

连接失败时,先检查 pvfUtility 是否已启动、PVF 是否已加载,以及 HTTP API 是否使用端口 27000;当前服务地址固定在 client.go 中。

常用操作

想做的事 使用的工具
按关键词找物品、技能或 NPC search_pvf
按物品代码查文件与名称 item_code_to_file_info
读取原文或结构化数据 get_file_content / get_file_data
批量读取文件或物品信息 batch_get_file_contents / batch_get_item_infos
查看索引和图标 get_lst_file_info / get_item_icon
获取编辑器当前文档与选中项 get_active_document / get_selected_files
导入、删除或保存文件 import_file / delete_file / save_pvf

Important

写操作先改变已加载的 PVF,调用 save_pvf 才会写入磁盘。修改前保留备份,并通过 output_path 指定另存路径。

结构化修改的完整流程:

get_file_data → 修改 JSON → serialize_file_data → import_file → save_pvf

全部工具、参数和示例见 Agent 工具手册。

从源码构建

当前源码要求 Go 1.26.2 或更高版本,具体以 go.mod 为准:

git clone https://github.com/Cec1c/PVF-MCP.git
cd PVF-MCP
go build -o pvf-mcp.exe .

构建后,Codex 用户运行本页的 codex mcp add 命令接入。仓库还保留了 install.ps1(PowerShell 5.1+)和旧版 INSTALL.md,其中的历史客户端路径需按实际环境调整。

文档与来源

内容 入口
工具参数、数据类型与操作示例 AGENT.md
MCP 工具注册与服务入口 server.go
PVF HTTP 客户端与文本序列化 client.go · serializer.go

基于 pvfUtility 的 HTTP API,使用 mcp-go 实现 MCP 服务。

反馈与交流

  • 问题与建议:GitHub Issues。
  • QQ交流群 : 908172336 (实际上是我开的公益群服,想玩也可以来看看)

About

一个用于pvfUtility 的MCP服务 使用GO语言编写

Resources

Stars

19 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages