Steam MCP

🚀 スチームMCPサーバー（Node.js/TypeScript）

このプロジェクトは、Node.js、TypeScript、および@modelcontextprotocol/sdkを使用して、スチームMCP（モデルコンテキストプロトコル）サーバーを実装しています。このサーバーは、MCPクライアント（例：Roo）とスチームウェブAPIをつなぐ仲介役として機能し、様々なスチームゲームの統計情報やユーザーデータに対する構造化されたアクセスを提供します。

サーバーは、標準入出力（stdio）を通じてMCPクライアントと通信し、@modelcontextprotocol/sdkのStdioServerTransportを使用します。tools/callリクエストを監視し、リクエストを検証し、Axiosを使ってスチームウェブAPIを呼び出し、整形された結果または適切なエラーメッセージを返します。

✨ 主な機能

このスチームMCPサーバーは、MCPクライアントとスチームウェブAPIを接続し、スチームゲームの統計情報やユーザーデータに対する構造化されたアクセスを提供します。具体的には、以下のような機能を備えています。

• 標準入出力（stdio）を通じてMCPクライアントと通信します。
• tools/callリクエストを監視し、検証します。
• Axiosを使ってスチームウェブAPIを呼び出します。
• 整形された結果または適切なエラーメッセージを返します。

📦 インストール

前提条件

• Node.js（推奨v18またはそれ以上）
• npm（通常はNode.jsと一緒に提供されます）

リポジトリのクローン（まだクローンしていない場合）

git clone <repository-url> # あなたのリポジトリURLに置き換えてください
cd steam-mcp

依存関係のインストール

npm install

環境変数の設定

サーバーは、以下の環境変数を設定する必要があります。

• STEAM_API_KEY（必須）：あなたのスチームウェブAPIキーです。スチーム開発者サイトでキーを取得してください。このキーがないと、サーバーは動作しません。

このプロジェクトでは、プロジェクトのルートディレクトリにある.envファイルを使用してAPIキーを読み込みます。.envという名前のファイルを作成し、以下の内容を追加してください。

STEAM_API_KEY=あなたのAPIキー

注意：.envファイルがバージョン管理システムに含まれないように、.gitignoreファイルに追加してください。

プロジェクトのビルド

npm run build

このコマンドは、TypeScriptコードをbuildディレクトリにコンパイルします。

🔧 技術詳細

💻 使用例

サーバーの起動

プロジェクトをビルドした後、以下のコマンドを実行してサーバーを起動します。

node build/index.js

利用可能なMCPコマンド

以下は、現在実装されているMCPコマンドのリストです。

isql:runQuery

SQLクエリを実行し、結果を返します。以下のパラメータを使用します。

ping:ping

サーバーが稼働しているかをテストします。

ローカルMCPクライアント（例：Roo）の接続

MCPクライアントをこのサーバーに接続するように設定するには、以下の手順に従ってください。

1. MCPクライアントの設定ファイル（通常は~/.mcp/settings.json）を開きます。
2. 以下のように新しい接続設定を追加します。

{
  "connections": [
    {
      "name": "steam", // 接続名
      "type": "stdio", // "stdio"である必要があります
      "enabled": true, // 接続を有効にするにはtrueに設定します
      "command": "node", // Node.jsランタイムを実行するコマンド
      "args": ["build/index.js"], // コマンドに渡す引数。ここではコンパイルされたサーバースクリプトのパスを指定します
      "cwd": "." // サーバーを実行する作業ディレクトリ（プロジェクトのルートディレクトリ）
    }
  ]
}

• name：この接続の一意の識別子（例：steam）。
• type：stdioである必要があります。
• enabled：接続を有効にするにはtrueに設定します。
• command：Node.jsランタイムを実行するコマンド（例：node）。
• args：コマンドに渡す引数。ここではコンパイルされたサーバースクリプトのパスを指定します（例：build/index.js）。
• cwd：サーバーを実行する作業ディレクトリ（プロジェクトのルートディレクトリ）。

設定が完了したら、ファイルを保存し、MCPクライアントを再起動します。これで、この接続を通じてサーバーと通信できます！