Aranet4 MCP Server

🚀 aranet4 - mcp - server

Aranet4二酸化炭素センサーを管理するためのMCPサーバーです。Aranet4 - Pythonをベースに構築されています。

💡 使用Tip

MCPロジックのない独立したPythonバージョンが必要な場合は、aranet4 - archiverをご覧ください。

✨ 主な機能

• 近くのデバイスをスキャンします。
• 組み込みデバイスのストレージから新しいデータを取得し、ローカルのsqliteデータベースに保存して、追跡や後での閲覧ができるようにします。自動更新については、以下を参照してください。
• recent measurementsの情報または特定の過去の日付の情報を照会します。
• [画像対応のMCPクライアント] データをグラフとして表示して、使いやすい視覚化を実現できます！
• 補助設定！ 💫 インストール後、クライアントで init aranet4 を入力するだけで、デバイスと一緒に使用するMCPサーバーを設定できます。

📦 インストール

1. リポジトリをクローンします：

   git clone git@github.com:diegobit/aranet4-mcp-server.git
   cd aranet4-mcp-server
   

2. 環境を準備します：

   • 推奨（uvを使用）：何も操作する必要はありません。提供されている pyproject.toml が依存関係と仮想環境を処理します。
   • 代替案（pipを使用）：pip install . を使用してインストールします。

3. MCPクライアントの設定に追加します：

   "aranet4": {
     "command": "{{PATH_TO_UV}}", // `which uv` を実行
       "args": [
         "--directory",
         "{{PATH_TO_SRC}}/aranet4-mcp-server/",
         "run",
         "src/server.py"
       ]
   }
   

   • Claude Desktop MacOSの設定ファイルのパス：~/Library/Application Support/Claude/claude_desktop_config.json
   • Cursor MacOSの設定ファイルのパス：~/.cursor/mcp.json

4. 設定を行います：

   • 推奨（AI補助設定！）：クライアントを起動した後、init aranet4 を入力して、ガイド付きの設定を行います。
   • 代替案（手動）：config.yaml ファイルを編集します。MACアドレスとデバイス名を提供する必要があります。MACアドレスは、Aranet4 - Python（このリポジトリの依存関係としてインストールされます）から aranetctl --scan を使用して取得できます。

Dockerfile

Dockerfileが提供されています。環境変数を渡すか、config.yaml を更新してください。

ツールリスト

設定とツール：

• init_aranet4_config：デバイスの設定を補助します。
• scan_devices：近くのBluetooth Aranet4デバイスをスキャンします。
• get_configuration_and_db_stats：現在の config.yaml とローカルのsqlite3データベースの一般的な統計情報を取得します。
• set_configuration：config.yaml の値を設定します。

過去のデータを更新する：

• fetch_new_data：設定された近くのAranet4デバイスから新しいデータを取得し、ローカルデータベースに保存します。

過去のデータを照会する：

• get_recent_data：ローカルデータベースから最近のデータを取得します。取得する測定値の数を指定できます。

• get_data_by_timerange：特定の期間内のローカルデータベースからデータを取得します。取得する測定値の数を指定できます（注意：時間範囲が広く、制限が低い場合、一部のデータポイントがスキップされる可能性があります）。

  どちらの場合も、グラフを生成して表示するように要求できます。

データの自動更新タスク

ローカルデータベースを常に最新の状態に保ちたい場合は、cronジョブまたはlaunch agentを設定して、数時間ごとに自動的にデータを取得することができます。MacOSでは、以下の手順に従ってください。

1. com.diegobit.aranet4 - fetch.plist の絶対パスを設定します。
2. LaunchAgentをインストールします：

   cp com.diegobit.aranet4-fetch.plist ~/Library/LaunchAgents/
   launchctl load ~/Library/LaunchAgents/com.diegobit.aranet4-fetch.plist
   

他のプラットフォームでは、好みの方法で fetch - job.py を定期的に実行してください。