aranet4 MCP Server

Čo robí “aranet4” MCP Server?

Aranet4 MCP Server je server Model Context Protocol (MCP) určený na správu vášho zariadenia Aranet4 CO2 senzor a pridruženej lokálnej databázy. Prepojením AI asistentov a externých dátových zdrojov umožňuje tento server bezproblémovú interakciu s vaším zariadením pre úlohy ako skenovanie blízkych zariadení, získavanie a ukladanie meraní, či dopytovanie historických údajov zo senzora. Podporuje automatické aktualizácie, asistovanú konfiguráciu a dokonca aj vizualizáciu dát pre klientov, ktorí podporujú obrázky. Server zjednodušuje vývojárske workflowy tým, že uľahčuje integráciu environmentálnych senzorových dát do širších LLM automatizácií, čo uľahčuje monitorovanie kvality vzduchu, sledovanie historických trendov a programovateľnú správu nastavení zariadenia.

Zoznam promptov

V repozitári alebo README nie sú zdokumentované žiadne explicitné prompt šablóny.

Zoznam zdrojov

V repozitári alebo README nie sú zdokumentované žiadne explicitné zdroje.

Zoznam nástrojov

Konfigurácia a nástroje:

• init_aranet4_config: Asistovaná konfigurácia zariadenia Aranet4.
• scan_devices: Skenuje blízke Bluetooth zariadenia Aranet4.
• get_configuration_and_db_stats: Získa aktuálny config.yaml a všeobecné štatistiky z lokálnej SQLite databázy.
• set_configuration: Nastaví hodnoty v rámci config.yaml.

Pre aktualizáciu historických dát:

• fetch_new_data: Získa nové dáta z nakonfigurovaného zariadenia Aranet4 a uloží ich do lokálnej databázy.

Pre dopytovanie historických dát:

• get_recent_data: Získa najnovšie dáta z lokálnej databázy; je možné špecifikovať počet meraní.

Príklady použitia tohto MCP Servera

• Monitorovanie prostredia: Automaticky skenujte a získavajte údaje o kvalite vzduchu a CO2 z blízkych zariadení Aranet4, uložte ich do lokálnej databázy na ďalšiu analýzu.
• Analýza historických dát: Dopytujte a prezerajte minulé merania zo senzorov pre identifikáciu trendov alebo anomálií v kvalite vzduchu v čase, čo je užitočné pre výskumníkov alebo správcov budov.
• Automatizovaná konfigurácia: Použite AI asistované alebo manuálne nástroje na rýchle nastavenie a konfiguráciu zariadení Aranet4, čím skrátite čas potrebný pre nenáročných používateľov.
• Vizualizácia a reportovanie: Pre klientov, ktorí podporujú výstup obrázkov, generujte a vizualizujte grafy najnovších meraní pre ľahkú interpretáciu a reportovanie.
• Správa flotily zariadení: Skenovanie a správa viacerých zariadení Aranet4 v priestore, umožňujúce centralizované monitorovanie a konfiguráciu.

Ako to nastaviť

Windsurf

1. Predpoklady: Uistite sa, že máte nainštalovaný Node.js a Python.
2. Naklonujte a nastavte server:

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

3. Nainštalujte závislosti: Použite uv alebo pip install . podľa preferencie.
4. Upravte Windsurf konfiguráciu: Pridajte aranet4 server do sekcie mcpServers.
5. Uložte a reštartujte Windsurf.
6. Overte: Skontrolujte, či je vaše zariadenie detegované a dáta sú dostupné.

Príklad JSON:

"mcpServers": {
  "aranet4": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/aranet4-mcp-server/",
      "run",
      "src/server.py"
    ]
  }
}

Poznámka: Pre zabezpečenie API kľúčov alebo citlivých údajov použite environmentálne premenné:

"aranet4": {
  "env": {
    "ARANET4_API_KEY": "your_api_key_here"
  },
  "inputs": {}
}

Claude

1. Postupujte podľa krokov 1–3 vyššie.
2. Upravte Claude Desktop konfiguračný súbor: Nachádza sa v ~/Library/Application Support/Claude/claude_desktop_config.json.
3. Pridajte aranet4 server ako vyššie.
4. Uložte a reštartujte Claude Desktop.
5. Použite init aranet4 pre sprievodcu nastavením.

Cursor

1. Postupujte podľa krokov 1–3 vyššie.
2. Upravte Cursor konfiguračný súbor: Nachádza sa v ~/.cursor/mcp.json.
3. Vložte aranet4 server JSON konfiguráciu.
4. Uložte a reštartujte Cursor.
5. Použite init aranet4 pre sprievodcu nastavením.

Cline

1. Postupujte podľa krokov 1–3 vyššie.
2. Upravte váš relevantný Cline konfiguračný súbor.
3. Pridajte aranet4 server JSON konfiguráciu.
4. Uložte a reštartujte Cline.
5. Použite interaktívny konfiguračný nástroj na nastavenie.

Ako použiť tento MCP vo workflowoch

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do vášho FlowHunt workflowu najprv pridajte MCP komponent do vášho workflowu a prepojte ho s AI agentom:

Kliknite na MCP komponent pre otvorenie konfiguračného panela. V sekcii konfigurácie systémového MCP vložte údaje vášho MCP servera v tomto JSON formáte:

{
  "aranet4": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po nakonfigurovaní môže AI agent používať tento MCP ako nástroj s prístupom ku všetkým jeho funkciám a možnostiam. Nezabudnite zmeniť “aranet4” na meno vášho vlastného MCP servera a URL na adresu vášho servera.

Prehľad

Náš názor

Aranet4 MCP server poskytuje silnú funkcionalitu pre správu zariadení Aranet4 a environmentálne snímanie s jasne vystavenými nástrojmi a dobrou podporou platforiem. Chýbajú však zdokumentované prompt šablóny a explicitné MCP zdroje, ako aj pokročilé MCP funkcie ako sampling a roots. Inštrukcie na nastavenie sú praktické a detailné, najmä pre populárne AI vývojárske nástroje. Celkovo ide o robustnú a praktickú MCP implementáciu pre svoju oblasť.

MCP skóre

Hodnotenie: 6/10 – Výborná špecializovaná funkcionalita pre konkrétne zariadenia, ale chýbajú širšie MCP funkcie a dokumentácia promptov/zdrojov.