MCP fyrir gervigreindaraðstoðarmenn

HAM MCP-netþjónninn (Model Context Protocol) tengir gervigreindaraðstoðarmann við tækin þín. Aðstoðarmaðurinn getur séð tækjalistann, núverandi mælingar og söguna. Hvert kall keyrir með reikningnum þínum og heimildum þínum á hverju tæki.

Upplýsingar um tenginguna

Atriði	Gildi
Vistfang	`https://api.hamsystems.eu/mcp/index.php`
Flutningur	HTTP, JSON-RPC 2.0
Útgáfa samskiptareglu	`2024-11-05`
Auðkenning	Haus `Authorization: Bearer-API YOUR_API_KEY`

Þú býrð til API-lykilinn á síðunni Reikningur. Sjá REST API.

Settu upp aðstoðarmanninn

Búðu til API-lykil.

Bættu netþjóninum við MCP-stillingar aðstoðarmannsins. Fyrir Claude Code er skráin .mcp.json:

{
  "mcpServers": {
    "ham": {
      "type": "http",
      "url": "https://api.hamsystems.eu/mcp/index.php",
      "headers": {
        "Authorization": "Bearer-API YOUR_API_KEY"
      }
    }
  }
}

Endurræstu aðstoðarmanninn.
Spurðu til dæmis “Sýndu mér tækin mín”. Aðstoðarmaðurinn kallar á verkfærið list_devices.

Verkfæri

Verkfæri	Færibreytur	Niðurstaða
`list_devices`	`compact` (sjálfgefið `true`)	Tækin þín. Með `compact: true`: `serialno`, `name`, `icon`, `groups`, `floorplans` og `count`. Með `compact: false`: allar upplýsingar, með stillingunum.
`get_device_state`	`serialno` (eitt númer eða listi)	Núverandi staða. Sama snið og `get_device_state.php`. Sjá REST API.
`get_device_history`	`serialno`, `level`, `bin`	Línur sögunnar. Sömu stig og bil og í sækja söguleg gögn.
`get_definitions`	`family_id` (valfrjálst), `include_readings` (sjálfgefið `true`)	Skilgreiningar fjölskyldunnar: mælingar, úttök, stillingar
`get_docs`	engar	Leiðbeiningar fyrir verkfærin
`send_command`	`serialno`, `command`	Sendir skipun til tækis eða hóps. Aðstoðarmaðurinn fær skipanirnar úr `get_docs`.

Dæmigerð röð kalla: list_devices, síðan get_definitions fyrir fjölskylduna, síðan get_device_state eða get_device_history.

Prófaðu með curl

curl -X POST https://api.hamsystems.eu/mcp/index.php \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_devices","arguments":{}}}'

Niðurstaðan er í result.content[0].text, sem JSON-texti:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"devices\":[{\"serialno\":\"e11:123\",\"name\":\"Fridge 1\",\"icon\":\"\",\"groups\":[],\"floorplans\":[]}],\"count\":1}" }
    ]
  }
}

Studdar aðferðir: initialize, notifications/initialized, tools/list, tools/call.

Villur

Kóði	Merking
`-32000`	Auðkenningarvilla (HTTP 401) eða villa í verkfæri
`-32700`	Meginmálið er ekki gilt JSON
`-32600`	Ógild JSON-RPC beiðni
`-32601`	Óþekkt aðferð
`-32602`	Nafn verkfærisins vantar
`-32603`	Innri villa

Sjá líka

Spjall við þjónustuver