niguangowo/dalamud-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

9 stars 0 forks 质量 60 趋势 28

Repository Install

Dalamud MCP 是 FINAL FANTASY XIV 的一款 Dalamud 插件，它在环回端口上托管一个模型上下文协议服务器，使 AI 代理能够访问运行中的游戏客户端的实时状态。

概览

Dalamud MCP 是 DALAMUD 为《最终幻想 XIV》设计的插件，它在环回端口上托管一个模型上下文协议服务器，使 AI 代理能够访问正在运行的游戏客户端的实时状态。该插件运行在游戏进程中，因此它读取客户端自身使用的相同内存：对象表、本地玩家、队伍和联盟、目标、FATE、货币、Excel 游戏数据，以及通过 FFXIVClientStructs 验证的任意原始内存。 MCP客户端连接到http://127.0.0.1:18777/mcp，调用107个工具——65个只读工具，加上42个可选择加入的变异工具，这些工具可以对游戏采取行动：施放动作、目标和移动、发送聊天、管理插件、驱动插件窗口、注入Dear ImGui输入，以及注册其他插件的IPC端点。后台事件收集器还将游戏状态变化记录到环形缓冲区，代理可以轮询该缓冲区，无需重读完整状态。

概述（AI 翻译）

英文 |简体中文

DalamudMCP 是 FINAL FANTASY XIV 的 Dalamud 插件。它为AI辅助提供了本地模型上下文协议服务器插件开发、运行时检查和游戏内验证。

该插件在游戏进程中运行，并会暴露角色、物体、队伍、物品栏、游戏数据和UI状态通过Dalamud服务和FFXIVClientStructs。它还提供经过验证的原始内存读取、事件收集、截图和插件间通信。当前目录包含115个工具：70个只读工具和45个变异工具。变异工具需要明确启用。

默认端点为http://127.0.0.1:18777/mcp。支持HTTP的MCP客户端直接连接; 仅限 Stdio 的客户端使用附带的桥接器。

验证范围： 离线检查涵盖协议、模式、加载及选定的原生内存操作。实时覆盖范围仅限于工具审核中记录的场景有>和截图指南。这些结果并不能证明与每个客户端或游戏状态的兼容性。

README

以下为原文 README 节选，完整内容请查看原文。

DalamudMCP

English | 简体中文

DalamudMCP is a Dalamud plugin for FINAL FANTASY XIV. It provides a local Model Context Protocol server for AI-assisted plugin development, runtime inspection and in-game validation.

The plugin runs within the game process and exposes character, object, party, inventory, game-data and UI state through Dalamud services and FFXIVClientStructs. It also provides validated raw-memory reads, event collection and inter-plugin communication. The current catalog contains 148 tools: 84 read-only and 64 mutating. Mutating tools require explicit enablement.

The default endpoint is http://127.0.0.1:18777/mcp. HTTP-capable MCP clients connect directly; stdio-only clients use the included bridge.

Validation scope: Offline checks cover protocol, schemas, loading and selected native-memory operations. Live coverage is limited to the scenarios documented in the tool audit. These results do not establish compatibility with every client or game state.

Install from a plugin repository
Build
Install as a dev plugin
Configure
Connect an agent
Tool reference
Safety model
Architecture
Verification
Limitations

Install from a plugin repository

Published releases are available from NiGuangOwO’s Dalamud plugin repository. Repository index:

https://raw.githubusercontent.com/NiGuangOwO/DalamudPlugins/main/pluginmaster.json

Launch the game with Dalamud enabled. Enter /xlsettings in chat to open Dalamud settings.
Under Experimental, locate Custom Plugin Repositories. Add the index URL above and save the settings.
Enter /xlplugins to open the Plugin Installer. Refresh the list and install DalamudMCP by NiGuangOwO. Subsequent releases are available through the same installer.
Enter /dalamudmcp status to inspect listener status, or /dalamudmcp to open plugin settings.

After installation, follow Configure and Connect an agent to complete client setup. Mutating tools remain disabled until enabled in plugin settings. New releases may take several minutes to appear because of GitHub’s index cache. When replacing a development installation, disable the dev copy before enabling the repository version.

Build

The project uses Dalamud.NET.Sdk. Build the plugin project directly from the repository root:

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "ffxiv": {
      "type": "http",
      "url": "http://127.0.0.1:18777/mcp",
      "headers": {
        "Authorization": "Bearer <token-if-you-set-one>"
      }
    }
  }
}