tibiawiki-mcp

tibiawiki-mcp

面向 TibiaWiki 的 MCP 服务。它能让 AI 助手回答维基自身无法解答的问题：

• 哪些生物怕火，且能提供超过 500 点经验？
• 哪些生物会掉落 Dragon Shield，掉落概率是多少？
• 我在哪里可以买到 Steel Helmet，价格是多少？

所有答案都来自随 MCP 服务安装的维基 SQLite 快照。查询只需毫秒，且可离线使用。该服务不会发起网络请求。

使用方法

托管服务，无需安装

将 https://mcp.tibia.sh/wiki 添加到你的 MCP 客户端，作为远程服务使用。无需账号或密钥。在 claude.ai 中，将其添加为自定义连接器。

每个 IP 地址每分钟最多可发送约 300 条消息，且不会记录请求日志。位于 https://mcp.tibia.sh 的首页会显示当前运行的版本。 tibia-sh/mcp.tibia.sh 中有详细信息。

Claude Code

在终端中将其安装为插件。你将获得 MCP 服务和一个技能，用来教会 Agent 识别数据中的陷阱，例如伤害修正值为 100 时表示无修正：

claude plugin marketplace add tibia-sh/tibiawiki-mcp
claude plugin install tibiawiki-mcp@tibiawiki-mcp

其他 MCP 客户端

将以下内容添加到客户端的 MCP 配置中，例如 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 .cursor/mcp.json。需要 Node 22.13 或更高版本：

{
  "mcpServers": {
    "tibiawiki": { "command": "npx", "args": ["-y", "@tibia.sh/tibiawiki-mcp"] }
  }
}

首次启动时会下载软件包及其 18 MB 索引。之后即可离线使用。

工具

你提出问题，助手会调用以下工具：

工具	能回答的问题
tibia_search	“有没有一个名称大致为 X 的页面？”或“列出所有坐骑。”也支持通过游戏显示的名称或复数形式匹配物品，例如“vial of lifefluid”
tibia_get	“告诉我关于 X 的所有信息。”X 是维基标题，可以是生物、物品、NPC、任务或法术。物品信息包括客户端 ID、游戏显示的名称和复数形式、是否可堆叠、是否可拾取或不可移动，以及哪些 NPC 会在哪里以什么价格收购。生物信息包括游戏显示的名称、行为（例如何时逃跑）以及每次击杀获得的金币。NPC 信息包括其收购和出售的物品
tibia_find_creatures	“哪些生物符合这些属性？”也可以按行为筛选，例如能否察觉隐形或是否可推动，并按每次击杀获得的金币排序
tibia_find_items	“哪些物品符合这些属性？”也可以按抗性、技能加成、灌注槽、重量、手持要求、客户端 ID、武器元素、生命或法力吸取，以及是否可堆叠或拾取筛选
tibia_find_spells	“30 级德鲁伊可以施放哪些治疗法术？”
tibia_find_quests	“20 级角色可以完成哪些任务，又能获得什么？”
tibia_find_houses	“Thais 最便宜且有两张床的房子是哪一间？”
tibia_how_to_obtain	“我在哪里能获得 X？”一次调用即可查询掉落、商贩和任务奖励。X 可以是维基标题，也可以是游戏显示的名称
tibia_find_updates	“2026 年骑士有哪些变化？”按文本和发布日期查询游戏更新
tibia_where_to_sell	“这些战利品我该卖到哪里？”按城市分组，列出每件物品出价最高的 NPC。也接受游戏显示的名称，例如“gold coins”；如果多个物品共享同一名称，也会一并列出
tibia_parse_loot	“这些战利品值多少钱？”粘贴游戏显示的战利品消息，即可获取每件物品的数量和 NPC 收购金币价格；按需逐行提供客户端 ID
tibia_find_travel	“哪艘船会去 Svargrond，票价是多少？”查询前往或离开某地的船只和魔毯路线及票价。每一行代表一段路程，并标明起点，而非规划好的完整行程

该服务会告诉助手如何解读数据，例如伤害修正值为 100 表示无修正。技能的作用 列出了这些陷阱。

数据的新鲜度

该索引是一个快照。每个答案都会通过 indexGeneratedAt 标明索引生成时间。索引以独立软件包 @tibia.sh/tibiawiki-data 的形式发布，每周二和周五重新构建，并在 Wiki 有更改时发布。全新安装会获取最新版本。托管服务会自动跟进每次发布。

获取整个索引

这些工具用于回答问题。如果你正在构建战利品筛选器、狩猎规划器或 Bot 的数据层，并且想要获取所有行，请直接安装索引：

npm install @tibia.sh/tibiawiki-data

它会导出 DB_PATH（即 index.db 的绝对路径）和 SCHEMA_VERSION。使用任意 SQLite 客户端以只读模式打开该文件即可。在 Node 22.13 或更高版本中，可以使用 node:sqlite：

import { DatabaseSync } from 'node:sqlite'
import { DB_PATH } from '@tibia.sh/tibiawiki-data'

const db = new DatabaseSync(DB_PATH, { readOnly: true })

其 README 介绍了各个表的内容和版本的工作方式。数据仍采用 CC BY-SA 许可，因此发布时请注明 TibiaWiki。

项目缘由

TibiaWiki 运行在 Fandom 上，且没有 Cargo、Semantic MediaWiki 或 CirrusSearch，因此无法按属性查询。所有结构化值都被困在 Infobox 的 wikitext 中，而内置搜索在搜索 fire resistant dragon 时会返回 Dragon Necklace。同一 Wiki 的公共 REST API 仅提供一个查询参数。构建本地索引是提出真正问题的唯一方法。

更多信息

• docs/USAGE.md => 详细介绍插件、如何自行通过 HTTP 提供服务，以及如何构建自己的索引
• docs/MAINTAINING.md => 如何开发服务并发布

署名

数据来自 TibiaWiki（https://tibia.fandom.com），采用 CC BY-SA 许可。Tibia 由 CipSoft 制作；游戏内容和图片版权归 CipSoft GmbH 所有。

该索引由我们复制的 tibiawiki-sql（Apache-2.0）生成，副本见此处。图片不会被获取或存储。

本项目自身的代码采用 MIT 许可，详见 LICENSE。该许可仅适用于代码。本项目提供的数据采用 CC BY-SA 许可，我们无权更改其许可。