Skip to main content
Glama
kinbeg

mcp-kr-controller

by kinbeg

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KR_TCP_HOSTNoTCP host
KR_TCP_PORTNoTCP port (default 8080)8080
KR_UDP_HOSTNoUDP host
KR_UDP_PORTNoUDP port (default 8080)8080
KR_SERIAL_PATHNoSerial port path (e.g. COM3, /dev/ttyUSB0)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
setup_connectionA

添加通讯连接。用户通过对话告知通讯方式后调用此工具。支持三种类型:serial(串口,需提供 path 如 COM3)、tcp(TCP透传,需提供 host 和 port)、udp(UDP透传,需提供 host 和 port)。添加后自动连接,可用于后续设备扫描。

list_connectionsA

列出当前所有通讯连接及其状态。用于确认已添加的连接。

remove_connectionA

移除一个通讯连接。同时会移除该连接上注册的所有设备。

auto_discoverA

设备搜索与添加(需先确认连接方式)。用户说「搜索设备」时,AI 必须先问清楚连接方式(串口/网络),再调用本工具。connection_type='network':自动尝试 V4 TCP 192.168.16.254:8080 和 V5 UDP 广播 192.168.1.255:8080, 多网卡环境自动匹配同网段本地网卡(如 255.255.255.0 子网)。connection_type='serial':需提供 path(如 COM3),可选 baudRate(默认 9600)。建立连接 → 广播搜索 → 查询 IO/模块 → 注册设备,全自动完成。如果默认地址连不上,会明确告知,届时请用户确认实际地址后用 setup_connection 手动指定。

scan_devicesA

扫描所有连接上的在线设备并自动注册。执行流程:1)广播查找命令发现设备 2)对每台设备查询 IO 通道数和功能模块 3)将设备信息注册到注册表并持久化。扫描完成后设备即可通过地址+回路号控制。首次使用时必须先调用此工具。

list_devicesA

列出所有已注册设备。显示每台设备的地址、IO通道数(DI/DO)、功能模块(存储/RTC)、连接方式。控制设备时用此工具确认设备地址和可用回路数。

get_function_modulesB

查询指定设备的功能模块(存储模块、RTC时钟)是否存在。

read_statusA

读取指定设备的全部输入和继电器当前状态。返回 16 路输入通断 + 16 路继电器通断。每次控制操作后也可查看状态变化。

all_relays_offA

一键断开全部继电器。发完即走不等应答,直接读状态确认。内部使用 SET_RELAY_MASK 单指令执行,比逐路操作快 N 倍。对应自然语言:全关、关闭所有开关、全部断开、all off。

all_relays_onA

一键吸合全部继电器。发完即走不等应答,直接读状态确认。内部使用 SET_RELAY_MASK 单指令执行,比逐路操作快 N 倍。对应自然语言:全开、打开所有开关、全部吸合、all on。

disconnect_relayB

断开指定设备指定一路继电器(OFF)。参数:address=机器地址, channel=回路号。

connect_relayB

吸合指定设备指定一路继电器(ON)。参数:address=机器地址, channel=回路号。

set_relays_by_maskC

按 16 位掩码批量设置继电器状态。掩码中 1=吸合, 0=断开,一次性设置所有回路。例如 mask=0x000F = 吸合第1-4路、断开第5-16路。

momentary_off_on_singleA

单路点动 OFF→ON:断开的继电器吸合指定时间后自动断开恢复。相当于按钮按下效果。参数:address, channel=回路号, time=持续时间。

momentary_on_off_singleA

单路点动 ON→OFF:吸合的继电器在指定时间后自动断开。相当于延时关闭。参数:address, channel=回路号, time=延时时间。

momentary_off_on_multiA

多路点动 OFF→ON(按位):指定的多路继电器吸合指定时间后自动断开恢复。

momentary_on_off_multiA

多路点动 ON→OFF(按位):指定的多路继电器在指定时间后自动断开。

blink_singleB

单路闪烁:指定继电器按设定时间周期性通断。

blink_multiA

多路闪烁(按位):指定的多路继电器按设定时间周期性通断。

group_disconnectA

组断开:按掩码断开指定继电器,其余通道保持原状态不变。

group_connectA

组吸合:按掩码吸合指定继电器,其余通道保持原状态不变。

group_toggleA

组翻转:按掩码翻转指定继电器状态(断开→吸合, 吸合→断开),其余通道保持不变。

ping_pongA

单灯 ping-pong 弹跳动画:从起始回路到终止回路的单个灯来回跑动效果。每次只亮一路,像乒乓球一样弹跳。内部连续发送多条 SET_RELAY_MASK 指令(fire-and-forget),一次调用完成全部动画。起始和结束自动全部断开,适配 TCP 透传设备(含 V4/V5)。最后自动读取状态确认终点位置。参数:address=设备地址, start=起始回路(默认1), end=终止回路(默认8), count=来回次数(默认1), delay=帧间隔秒数(默认0.1)。对应自然语言:跑马灯、ping-pong、来回弹跳、弹弹球。

wait_di_triggerA

监听指定 DI 通道的上升沿触发(无输入→有输入),触发后自动执行指定动作。轮询 READ_STATUS 检测状态变化,检测到触发后执行动作并返回结果。参数:address=设备地址, channel=监听的DI通道号(默认1), timeout=超时毫秒(默认60000), poll_interval=轮询间隔毫秒(默认200), action=触发后执行的动作(默认ping_pong, 可选all_relays_on/all_relays_off), start/end/count/delay=ping_pong动作参数。对应自然语言:检测到输入触发时执行、当DI1有信号时跑马灯、输入触发动画。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kinbeg/mcp-kr-controller'

If you have feedback or need assistance with the MCP directory API, please join our Discord server