SwitchBot MCPサーバ紹介

今回作成したSwitchBotのMCPサーバは下記のリポジトリで公開しています。

設定方法

MCPサーバの設定方法はGitHubのREADMEにも記載してあります📝

今回はSwitchBot APIを使用するためSwitchBotのアプリの「開発者向けオプション」からトークンとシークレットを準備する必要があります。
（初回はアプリバージョンを10回タップして「開発者向けオプション」を表示させる必要があります）

MCPサーバのバイナリはreleasesページで配布しているのでダウンロードしてください。

現状ローカルでMCPサーバを動かすことが多い中で、Go言語の複数プラットフォーム向けのバイナリを簡単に準備して配布できる点はGo言語でMCPサーバを作るメリットだなと思いました

Claude DesktopのMCPサーバの設定は下記のようにバイナリを指定して、トークンとシークレットをenvに記載してください。

{
  "mcpServers": {
    "switchbot": {
      "command": "~/Downloads/switch-bot-mcp-server",
      "env": {
        "SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN",
        "SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET"
      }
    }
  }
}

使い方

現在はデバイス一覧の取得と、各デバイスのステータス取得、デバイスのON/OFFのToolのみを実装しています。

上記のように単純なToolのみしか実装していないですが、LLMを介すことでデバイスをON/OFFするような単純なことだけでなく、下記のように複数のデバイスにまたがって操作を指示することができるようになります。

今回実装したToolやレスポンスについてLLM向けの説明を全然書いていないですが、SwitchBotが一般的に広まっていてLLMの事前学習データに含まれているため特に説明しないでも良い感じに動いているのかなと思いました

他にもこのMCPサーバを使用して便利な使い方など見つけましたらコメントでぜひ教えてください！

mcp-goの使い方

この記事時点ではmcp-goはv0.22.0を使用しているので、実装方法が変わっている可能性などには注意してください。

MCPサーバ起動とToolの実装方法

簡単な紹介ですがToolの実装であれば下記の通りすぐに実装することができます！
その他の細かい使い方はmcp-goのexamplesなどが参考になると思います。

package main

import (
	"context"
	"fmt"
	"github.com/mark3labs/mcp-go/mcp"
	"github.com/mark3labs/mcp-go/server"
)

func main() {
	// MCPサーバの定義
	mcpServer := server.NewMCPServer(
		"Tax MCP",
		"0.1.0",
	)

	// Toolの追加
	mcpServer.AddTool(
		mcp.NewTool(
			"calc_tax",
			mcp.WithDescription("税抜き金額を受け取って税込金額を返す"),
			mcp.WithNumber("price", mcp.Required(), mcp.Description("税抜き金額")),
		),
		func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
			price := request.Params.Arguments["price"].(float64)
			tax := 0.1
			taxIncludedPrice := price * (1 + tax)
			return mcp.NewToolResultText(fmt.Sprintf("%.2f", taxIncludedPrice)), nil
		},
	)

	// stdioを介したMCPサーバを起動
	if err := server.ServeStdio(mcpServer); err != nil {
		fmt.Printf("Server error: %v\n", err)
	}
}