TF2 Wiki

tf2-wiki-mcp

一个 MCP 服务，通过标准输入输出向 LLM 客户端（Claude Desktop、Claude Code、Cursor、VS Code）提供 Team Fortress Wiki 的内容。

与 Valve Corporation 或 Team Fortress Wiki 贡献者无关。 Team Fortress 2 是 Valve Corporation 的商标。这是非官方的粉丝工具。

功能

让 LLM 实时、准确地获取 TF2 Wiki 内容，不再臆测武器属性、更新说明和装饰品详情。

• 通用 Wiki 访问 — 搜索、获取页面、查看摘要、列出最近更改。
• TF2 领域工具 — 结构化武器属性、职业装备配置、装饰品查询、活动物品列表、更新说明。

工具

此外还提供：资源 tf2wiki://main，以及提示词 analyze_loadout 和 compare_weapons。

安装

需要 uv（它会为你管理 Python 工具链）。安装后，uvx tf2-wiki-mcp 会按需获取并运行服务，无需手动克隆。

标准配置适用于大多数 MCP 客户端：

{
  "mcpServers": {
    "tf2-wiki-mcp": {
      "command": "uvx",
      "args": ["tf2-wiki-mcp"],
      "env": {}
    }
  }
}

claude mcp add tf2-wiki-mcp -- uvx tf2-wiki-mcp

[mcp_servers.tf2-wiki-mcp]
command = "uvx"
args = ["tf2-wiki-mcp"]

code --add-mcp '{"name":"tf2-wiki-mcp","command":"uvx","args":["tf2-wiki-mcp"],"env":{}}'

code-insiders --add-mcp '{"name":"tf2-wiki-mcp","command":"uvx","args":["tf2-wiki-mcp"],"env":{}}'

{
  "mcpServers": {
    "tf2-wiki-mcp": {
      "command": "uvx",
      "args": ["tf2-wiki-mcp"],
      "env": {},
      "type": "local",
      "tools": ["*"]
    }
  }
}

开发

从本地克隆运行，而不是从 PyPI 运行：

git clone https://github.com/yusufaf/tf2-wiki-mcp
cd tf2-wiki-mcp
uv sync --dev
uv run pytest              # offline, uses recorded cassettes
uv run pytest --live       # also hits the real wiki

将 MCP 客户端指向本地检出目录：

{
  "mcpServers": {
    "tf2-wiki-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/tf2-wiki-mcp", "tf2-wiki-mcp"]
    }
  }
}

许可与归属

代码： MIT（参见 LICENSE）。

Wiki 内容： 不会再分发。本项目不包含任何抓取的 Wiki 数据。只有在用户发出请求时，才会从 wiki.teamfortress.com 实时获取页面内容，并直接返回给用户的 LLM 客户端——这与浏览器扩展的处理方式相同。

Wiki 内容的版权归相应贡献者所有，并受 Valve 的 Steam 订阅协议（游戏网站条款）约束。本工具的用户有责任遵守 Valve 的条款。代码许可 ≠ 内容许可：MIT 许可涵盖的是本代码库，而非其获取的 Wiki 内容。

根据 MediaWiki 礼仪，向 Wiki 发送的请求会包含描述性的 User-Agent（tf2-wiki-mcp/<version> (https://github.com/yusufaf/tf2-wiki-mcp)），并遵守 maxlag/Retry-After 响应。

贡献

请勿提交抓取的 Wiki 文本。用于解析器测试的 infobox 示例没问题（短小、符合合理使用标准的测试样例）。完整页面转储则不行。