TF2 Wiki

tf2-wiki-mcp

Team Fortress Wiki を stdio 経由で LLM クライアント（Claude Desktop、Claude Code、Cursor、VS Code）に公開する MCP サーバーです。

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 Subscriber Agreement（ゲームサイトの利用規約）が適用されます。このツールのユーザーは、Valve の規約を遵守する責任があります。コードのライセンス ≠ コンテンツのライセンス：MIT ライセンスが適用されるのはこのコードベースであり、取得する Wiki コンテンツではありません。

Wiki へのリクエストには、MediaWiki のマナーに従って説明的な User-Agent（tf2-wiki-mcp/<version> (https://github.com/yusufaf/tf2-wiki-mcp)）を含め、maxlag／Retry-After のレスポンスを尊重します。

コントリビューション

スクレイピングした Wiki のテキストをコミットしないでください。パーサーのテスト用のインフォボックスの例（短く、フェアユースの範囲に収まるテスト用データ）は問題ありません。ページ全体のダンプは不可です。