steam-mcp

特定の人物に合うSteamゲームを判断するためのMCPサーバーです。プレイヤーが実際にプレイ時間を記録しているゲームと、そのプレイヤーが今すぐ何を求めているかを口にする内容をブレンドして、ストア全体をランキングします。

ツールは10個あります。recommend_games が正面の入口であり、残りはランキングを鵜呑みにせず検証できるように存在しています。

実行

npm install && npm run build
claude mcp add -s user steam-mcp -e STEAM_ID=<your SteamID64> -- node /path/to/steam-mcp/dist/index.js

環境変数:

• STEAM_ID (任意): デフォルトのプレイヤーを SteamID64 で指定します。ツールは呼び出しごとにバニティ名やプロフィールURLも受け入れます。

• STEAM_API_KEY (任意): https://steamcommunity.com/dev/apikey から取得します。これはライブラリ、最近のプレイ、バニティ名解決のパスだけに必要です。公開プロフィールのウィッシュリストを含めて、それ以外はすべてキー不要なので、このサーバーは資格情報がまったくなくても役に立ちます。ただしパーソナライズだけはできません。

ディスクキャッシュは $XDG_CACHE_HOME/steam-mcp (デフォルトは ~/.cache) に置かれます。ストアの appdetails エンドポイントはIPごとに5分間で約200リクエストに制限されるため、クライアントはそのエンドポイントへのアクセス間隔を1.5秒にし、それ以外ははるかに速く処理して、積極的にキャッシュします（詳細は6時間、タグとDeckデータは1週間）。これにより、同じ場で続けて2回目のレコメンドをしても、ほとんど追加コストがかかりません。リストを充実させるツールはどれも期限付きで動作し、スキップしたゲームの数を報告するため、長いリクエストはプロキシでタイムアウトするのではなく、部分的な回答を返します。

Related MCP server: Steam Review and Forum MCP

ランキングの仕組み

src/taste.ts にモデル全体が入っています。

プロフィール。 プレイした各ゲームの時間を、コミュニティタグの投票割合に比例して配分します。そのため、ミルシムの時間はほぼ Military と Tactical に配られ、Multiplayer にはわずかな一部だけが配られます。その上に、3つの補正を重ねます：

• タグは、Steam 自身のタグ辞書での人気順から導かれる希少度で重み付けされます（追加のリクエストは不要）。この補正がなければ、誰のプロフィールも皆 Action、Open Welt、Simulation から始まってしまいます。

• 1つのスタジオのゲームは一緒にまとめてから圧縮します。Arma の3個のエントリは、1つの趣味の3回分の測定であって、3倍の証拠ではありません。

• プレイ時間は平方根を取ります。外れ値が1つあっても先頭は走りますが、プロフィール全体を作るほどではありません。

キーが使える場合は、過去2週間のプレイが生涯のプレイ時間に加えて2回カウントされます。1回は履歴として、もう1回はプレイヤーが今はまっているものとしてです。

スコア。 同じ 0..1 スケールの2つのシグナルを均等にブレンドします。 fit は候補ゲームのタグベクトルとプロフィールのコサイン距離を、どのゲームでも出し得る最大値と比べた相対値です。 want は、候補のタグのうち、プレイヤーが求めた内容にどのくらい一致するかです。次に、レビュー評価は Steam の "Mostly Positive" ライン (70%) を下回った場合のみペナルティを課し、それ以上を増強することはありません。候補はもともとレビュー順に並んでいる状態で届くため、再び報奨を与えると人気を二重に数えることになるます。そして、報告される各 matchedOn エントリはスコア・ポイントで表され、そのポイントがライブラリとリクエストのどちらから得たかを示します。

順序。 最終的なリストは、多様性を残すため貪欲法で再ランンキングします。すでに選択されたゲームに似ていると最大 20 分低下します。ただしスコアそのものは変化せず、順番だけが変わります。ツールの説明にもそう明記されています。

テスト

npm test

どちらのスイートも、意図的に実 API に対し実行します。test/smoke.mjs はビルドしたサーバーを実際のMCP stdio た通して動かし、これは静かに喪失したスキーマや変更されたストアのエンドポイントが検出できる唯一の場所です。 test/taste.ts は test/fixtures/library.json — 実際の45ゲームからなるライブラリ — に対してモデルを走らせ、タグ票推移するので、正確な数値ではなくランキングの挙動を確認します。 STEAM_API_KEY を設定キー付きのツールもテストできます。

キーを付けてのデプロイ

長期稼働するstdio サーバーはリクエストスコープのシークレット・ブローカーからキーを受け取れないので、キーを使うデプロイは、プロセス起動時に環境変数を注入できる場所に置くのが場です。すなわち superend の environment= 行、Nomad 変数、systemd の EnvironmentFile などです。サーバーは起動時に STEAM_API_KEY を一度だけ読み取り、どこにも書き出すことはしません。