TF2 Wiki

io.github.yusufaf由 GitHub 帳號 yusufaf 發布v0.1.2更新於 Oct 30, 2026

Live Team Fortress Wiki access: search, pages, weapon stats, loadouts, patch notes.

已驗證STDIO僅桌面網頁搜尋與抓取知識與記憶

概覽

AI 產生的概覽

非官方 MCP 伺服器，讓助理即時存取《絕地要塞2》Wiki：搜尋、頁面、武器數據、配裝、裝飾品與更新日誌。

可以做什麼
  • 搜尋 Wiki，並以 wikitext、純文字或 HTML 形式讀取頁面，附摘要與章節目錄
  • 依命名空間列出最近編輯的頁面
  • 取得從資訊框解析的結構化武器數據，並列出某職業的所有武器
  • 查詢裝飾品資訊框參數，以及某次活動或更新新增的物品
  • 取得指定更新或修補頁面的更新日誌
適用情境
適合讓助理依據真實 Wiki 回答 TF2 問題，而不是憑猜測：武器傷害與屬性、職業配裝、裝飾品細節、活動物品清單和更新日誌。
執行需求
以 PyPI 套件形式透過 stdio 在本機執行；README 要求安裝 uv，並以 uvx 啟動。未宣告帳號、API 金鑰或環境變數。內容為即時抓取，需要能連線至 TF2 Wiki 的網路。
安裝前請注意
僅做唯讀查詢，但每次請求都會送往外部 TF2 Wiki 網站，查詢字詞和頁面標題會離開本機。屬非官方粉絲工具，與 Valve 及 Wiki 貢獻者無關；Wiki 內容不隨套件散布，使用者需自行遵守 Valve 的條款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 TF2 Wiki，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

tf2-wiki-mcp

An MCP server that exposes the Team Fortress Wiki to LLM clients (Claude Desktop, Claude Code, Cursor, VS Code) over stdio.

[Install in VS Code] [Install in VS Code Insiders] [Install in Visual Studio] [Install in Cursor]

Not affiliated with Valve Corporation or the Team Fortress Wiki contributors. Team Fortress 2 is a trademark of Valve Corporation. This is unofficial fan tooling.

What it does

Gives an LLM live, accurate access to TF2 wiki content so it stops guessing at weapon stats, patch notes, and cosmetic details.

  • Generic wiki access — search, fetch pages, get summaries, list recent changes.
  • TF2 domain tools — structured weapon stats, class loadouts, cosmetic lookup, event item lists, patch notes.

Tools

ToolPurpose
search_wiki(query, limit)Full-text search
get_page(title, format)Page content as wikitext, plain, or html
get_page_summary(title)Lead-section plaintext
get_page_sections(title)Section TOC for selective fetching
get_recent_changes(limit, namespace)Recently edited pages
get_weapon_stats(weapon_name)Parsed weapon infobox → structured stats
list_class_loadout(class_name)All weapons in a class's wiki category
get_cosmetic(name)Cosmetic item infobox params
list_event_items(event_name)Items added in an update/event
get_patch_notes(update_name)Patch notes for a specific update

Plus: resource tf2wiki://main, prompts analyze_loadout and compare_weapons.

Installation

Requires uv (which manages the Python toolchain for you). Once installed, uvx tf2-wiki-mcp will fetch and run the server on demand — no manual clone needed.

Standard config works in most MCP clients:

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

Add the standard config above to claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop. The TF2 wiki tools appear in the tool picker.

Claude Code
bash
claude mcp add tf2-wiki-mcp -- uvx tf2-wiki-mcp
Codex

Add to ~/.codex/config.toml:

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

See the Codex MCP docs.

Cursor

[Install in Cursor]

Or add the standard config to ~/.cursor/mcp.json.

Gemini CLI

Add the standard config to your Gemini CLI settings.json per the Gemini CLI MCP guide.

VS Code

[Install in VS Code]

Or via the VS Code CLI:

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

See the VS Code MCP guide for details.

VS Code Insiders

[Install in VS Code Insiders]

Or via the CLI:

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

[Install in Visual Studio]

Or manually:

  1. Open the GitHub Copilot Chat window.
  2. Click the tools icon (🛠️) → + Add Server.
  3. Fill in: Server ID tf2-wiki-mcp, Type stdio, Command uvx, Arguments tf2-wiki-mcp.
  4. Save.

See the Visual Studio MCP docs.

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

Add this in repository settings under Copilot → Coding agent. See the Copilot Coding Agent MCP docs.

Development

Run from a local clone instead of PyPI:

bash
git clone https://github.com/yusufaf/tf2-wiki-mcpcd tf2-wiki-mcpuv sync --devuv run pytest              # offline, uses recorded cassettesuv run pytest --live       # also hits the real wiki

To point an MCP client at the local checkout:

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

Licensing & Attribution

Code: MIT (see LICENSE).

Wiki content: Not redistributed. This project contains zero scraped wiki data. All page content is fetched live from wiki.teamfortress.com at the user's request and returned directly to the user's LLM client — the same posture as a browser extension.

Wiki content is © its respective contributors under Valve's Steam Subscriber Agreement (Game Site terms). Users of this tool are responsible for compliance with Valve's terms. Code license ≠ content license: MIT covers this codebase, not the wiki content it fetches.

Requests to the wiki include a descriptive User-Agent (tf2-wiki-mcp/<version> (https://github.com/yusufaf/tf2-wiki-mcp)) per MediaWiki etiquette and respect maxlag/Retry-After responses.

Contributing

Don't check in scraped wiki text. Infobox examples for parser tests are fine (short, fair-use-grade fixtures). Full page dumps are not.

來源：README.md，提交 46ed09b

工具

10

search_wiki

Search Wiki

Full-text search the TF2 Wiki. Returns title + snippet + wordcount for each hit.

輸入參數limitquery必填

get_page

Get Page

Fetch a single TF2 Wiki page. `format` picks raw wikitext, plaintext extract, or rendered HTML.

輸入參數title必填format

get_page_summary

Get Page Summary

Lead-section plaintext summary of a page. Fast context anchor.

輸入參數title必填

get_page_sections

Get Page Sections

Section table-of-contents for a page; use before get_page to fetch selectively.

輸入參數title必填

get_recent_changes

Get Recent Changes

Recently edited pages in the given namespace (0 = main/articles).

輸入參數limitnamespace

get_weapon_stats

Get Weapon Stats

Fetch a weapon page and return structured stats parsed from its infobox. Returns damage, rate-of-fire, reload, clip size, attributes (+/- effects), etc.

輸入參數weapon_name必填

list_class_loadout

List Class Loadout

List all weapons for the given class. Intersects Category:<Class> with Category:Weapons on the wiki.

輸入參數class_name必填

get_cosmetic

Get Cosmetic

Fetch a cosmetic item page and return its infobox params.

輸入參數name必填

list_event_items

List Event Items

List items added during a given TF2 event/update (e.g. 'Jungle Inferno Update', 'Smissmas 2023').

輸入參數event_name必填

get_patch_notes

Get Patch Notes

Fetch patch notes for a named update or patch page (e.g. 'October 5, 2023 Patch').

輸入參數update_name必填

版本歷史

1
  1. v0.1.2最新Oct 29, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分