Skip to main content
Glama
enesjakozh

Google Home MCP Server

by jmagar
GitHub
TypeScript
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Google Home MCP サーバー

Smart Home API を介して Google Home スマートプラグを制御するための MCP サーバー実装。

特徴

  • 利用可能なすべてのスマートプラグとその状態を一覧表示します
  • スマートプラグを制御する（オン/オフ）
  • 特定のスマートプラグのリアルタイムの状態を取得する
  • デバイスの自動状態更新
  • スマートホーム API による OAuth2 認証

前提条件

  1. スマートホーム API が有効になっている Google Cloud プロジェクト
  2. Google スマートホーム アクション プロジェクトでのアクション
  3. スマートホームアクションのOAuth 2.0クライアント認証情報
  4. Node.js 18以上
  5. Google Homeスマートプラグへのアクセス

設定

  1. スマートホームアクションを作成する:
    • Google ConsoleのActionsに移動
    • 新しいプロジェクトを作成する
    • プロジェクトの種類として「スマートホーム」を選択します
    • アカウントリンクを構成する:
      • OAuth クライアント ID
      • OAuth クライアントシークレット
      • 認証URL
      • トークンURL
  2. OAuth 2.0 を設定します。
    • OAuthサーバーのエンドポイントを構成する
    • ユーザー認証フローを設定する
    • トークン生成/検証を実装する
  3. 依存関係をインストールします:
pnpm install
  1. サーバーを構成します。
    • config.json.exampleをconfig.jsonにコピーします。
    • 以下にご記入ください:
      • OAuth クライアント ID
      • OAuth クライアントシークレット
  2. サーバーを構築します。
pnpm build
  1. サーバーを起動します。
pnpm start

利用可能なツール

1. スマートプラグを一覧表示する

{ name: "list_smart_plugs", description: "List all available smart plugs and their current states", response: Array<{ id: string; name: string; state: { on: boolean; online: boolean; } }> }

2. スマートプラグを制御する

{ name: "control_smart_plug", description: "Turn a smart plug on or off", parameters: { deviceId: string; // Device ID from list_smart_plugs state: boolean; // true for on, false for off }, response: { success: boolean; device: { id: string; name: string; state: { on: boolean; online: boolean; } } } }

3. スマートプラグの状態を取得する

{ name: "get_smart_plug_state", description: "Get the current state of a specific smart plug", parameters: { deviceId: string; // Device ID from list_smart_plugs }, response: { id: string; name: string; state: { on: boolean; online: boolean; } } }

APIの詳細

サーバーは Smart Home API インテントを実装します。

  1. SYNCインテント
    • ユーザーがアカウントをリンクしたときに呼び出されます
    • 利用可能なデバイスと機能を報告します
    • デバイスの検出を処理する
  2. クエリの意図
    • デバイスの現在の状態を報告します
    • Google アシスタントからの状態クエリを処理
    • オンライン/オフラインステータスを返します
  3. 実行意図
    • デバイス制御コマンドを処理する
    • オン/オフ操作を実行します
    • コマンドの成功/失敗を報告します

エラー処理

サーバーは、特定のエラー コードを使用して包括的なエラー処理を実装します。

  • CONFIG_ERROR : 構成の読み込みまたは検証エラー
  • API_ERROR : スマートホーム API からのエラー
  • DEVICE_NOT_FOUND : 利用可能なデバイスにデバイスIDが見つかりません
  • COMMAND_ERROR : デバイスコマンドの実行中にエラーが発生しました

各エラーには次の内容が含まれます。

  • エラーメッセージ
  • エラーコード
  • 詳細なエラー情報（利用可能な場合）

安全

  • OAuth 2.0認証フロー
  • 安全なトークン処理
  • リクエストの検証
  • コマンド承認
  • HTTPS通信
  • 入力サニタイズ

発達

  1. 開発モードで開始します:
pnpm dev
  1. テストを実行します:
pnpm test
  1. デバッグ ログ:
    • すべてのAPI呼び出しが記録されます
    • エラーの詳細が記録される
    • デバイスの状態変化が追跡される

貢献

  1. リポジトリをフォークする
  2. 機能ブランチを作成する
  3. 変更をコミットする
  4. ブランチにプッシュする
  5. プルリクエストを作成する

ライセンス

マサチューセッツ工科大学

ghome-mcp-server

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

ユーザーは、OAuth2 認証を使用した Smart Home API を使用して Google Home スマートプラグを制御でき、リアルタイムのデバイス状態管理と制御操作が可能になります。

  1. 特徴
    1. 前提条件
      1. 設定
        1. 利用可能なツール
          1. スマートプラグを一覧表示する
          2. スマートプラグを制御する
          3. スマートプラグの状態を取得する
        2. APIの詳細
          1. エラー処理
            1. 安全
              1. 発達
                1. 貢献
                  1. ライセンス
                    1. ghome-mcp-server

                      Related Resources

                      Related MCP Servers

                      • homeassistant-mcp

                        tevonsb
                        -
                        security
                        A
                        license
                        -
                        quality
                        Access Home Assistant data and control devices (lights, switches, thermostats, etc).
                        Last updated -
                        6
                        123
                        TypeScript
                        Apache 2.0

                      • Google Workspace MCP Server

                        aaronsb
                        -
                        security
                        A
                        license
                        -
                        quality
                        Provides authenticated access to Google Workspace APIs with a focus on Gmail operations and planned Calendar support, featuring secure OAuth authentication and multi-account management with detailed error handling.
                        Last updated -
                        73
                        TypeScript
                        MIT License
                        • Linux
                        • Apple

                      • Gmail MCP Server

                        Quantum-369
                        -
                        security
                        A
                        license
                        -
                        quality
                        Enables interaction with Gmail through the Gmail API to read, send, and manage emails. Supports multiple Gmail accounts with real-time monitoring and advanced features for email search and attachment handling.
                        Last updated -
                        8
                        Python
                        Apache 2.0
                        • Apple
                        • Linux

                      • MCP G Suite Integration

                        alBERT-launcher
                        -
                        security
                        A
                        license
                        -
                        quality
                        Integration server that enables interaction with Google services including Gmail and Calendar, allowing users to manage emails, draft responses, and schedule events across multiple Google accounts.
                        Last updated -
                        Python
                        MIT License
                        • Apple

                      View all related MCP servers

                      Appeared in Searches

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/jmagar/ghome-mcp-server'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server