mcp-xiv客户端结构
工具
| 工具 | 说明 |
|---|---|
search_types | 按名称或命名空间搜索类型--返回简短结果（无字段/方法） |
get_type | 完整类型定义：具有偏移量、方法、大小、继承的字段 |
list_namespaces | 所有可用命名空间 |
get_namespace | 命名空间中的所有类型（简短） |
refresh | 快跑 git pull 如果SHA发生变化，请在回购上重建索引 |
环境变量
| 变量 | 描述 |
|---|---|
FFXIV_STRUCTS_REPO | 本地克隆的路径 FFXIV客户端结构 |
FFXIV_STRUCTS_INDEX | 服务器写入其数据的路径 index.json 缓存（不需要事先存在） |
两者都是必需的。如果缺少任何一个，服务器将在启动时退出。
设置
1.在某处克隆FFXIVClientStructs：
git clone https://github.com/aers/FFXIVClientStructs.git /path/to/ffxiv_clientstructs_repo2.安装和构建：
npm install
npm run build3.添加到MCP主机的配置中：
{
"mcpServers": {
"ffxiv-structs": {
"command": "node",
"args": ["/path/to/mcp-xiv-clientstructs/dist/index.js"],
"env": {
"FFXIV_STRUCTS_REPO": "/path/to/ffxiv_clientstructs_repo",
"FFXIV_STRUCTS_INDEX": "/path/to/mcp-xiv-clientstructs/index.json"
}
}
}
}首次启动时，索引会自动构建（约2-5秒）。后续启动会立即加载缓存的索引，除非仓库SHA发生了变化。
保持最新
每次启动时，服务器都会将仓库的当前git SHA与缓存的索引进行比较。如果它们不同（例如，因为你从外部拉），它会自动重建。
这 refresh 该工具无需重新启动即可一步完成此操作：它运行 git pull 如果SHA发生变化，则重新构建索引。游戏补丁后打电话很有用。