MCP do chúntóirí AI

Ceanglaíonn freastalaí MCP (Model Context Protocol) HAM cúntóir AI le do ghléasanna. Feiceann an cúntóir liosta na ngléasanna, na léamha reatha agus an stair. Ritheann gach glao le do chuntas agus le do cheadanna ar gach gléas.

Sonraí an cheangail

Mír	Luach
Seoladh	`https://api.hamsystems.eu/mcp/index.php`
Iompar	HTTP, JSON-RPC 2.0
Leagan an phrótacail	`2024-11-05`
Fíordheimhniú	An ceanntásc `Authorization: Bearer-API YOUR_API_KEY`

Cruthaíonn tú an eochair API ar an leathanach Cuntas. Féach an REST API.

Socraigh an cúntóir

Cruthaigh eochair API.

Cuir an freastalaí le cumraíocht MCP do chúntóra. Do Claude Code, is é .mcp.json an comhad:

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

Atosaigh an cúntóir.
Fiafraigh, mar shampla, “Taispeáin mo ghléasanna dom”. Glaonn an cúntóir ar an uirlis list_devices.

Uirlisí

Uirlis	Paraiméadair	Toradh
`list_devices`	`compact` (réamhshocrú `true`)	Do ghléasanna. Le `compact: true`: `serialno`, `name`, `icon`, `groups`, `floorplans` agus `count`. Le `compact: false`: na sonraí go léir, leis na socruithe.
`get_device_state`	`serialno` (uimhir amháin nó liosta)	An staid reatha. An fhormáid chéanna le `get_device_state.php`. Féach an REST API.
`get_device_history`	`serialno`, `level`, `bin`	Sraitheanna na staire. Na leibhéil agus na binní céanna agus atá in íoslódáil sonraí staire.
`get_definitions`	`family_id` (roghnach), `include_readings` (réamhshocrú `true`)	Sainmhínithe na dteaghlach: léamha, aschuir, socruithe
`get_docs`	ceann ar bith	Treoracha do na huirlisí
`send_command`	`serialno`, `command`	Seolann sé ordú chuig gléas nó grúpa. Faigheann an cúntóir na horduithe ó `get_docs`.

Ord glaonna tipiciúil: list_devices, ansin get_definitions don teaghlach, ansin get_device_state nó get_device_history.

Tástáil le 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":{}}}'

Tá an toradh in result.content[0].text, mar théacs JSON:

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

Modhanna a dtacaítear leo: initialize, notifications/initialized, tools/list, tools/call.

Earráidí

Cód	Brí
`-32000`	Earráid fíordheimhnithe (HTTP 401) nó earráid uirlise
`-32700`	Ní JSON bailí é an corp
`-32600`	Iarratas JSON-RPC neamhbhailí
`-32601`	Modh anaithnid
`-32602`	Tá ainm na huirlise in easnamh
`-32603`	Earráid inmheánach

Féach freisin

Comhrá leis an tacaíocht