Skip to content

Commit 868a3f1

Browse files
committed
remove get_device_documentation tool and clean up stale references
1 parent c302143 commit 868a3f1

File tree

8 files changed

+7
-100
lines changed

8 files changed

+7
-100
lines changed

src/mcp/services/mcp-server.factory.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Key Concepts:
4747
- UUID format: MongoDB _id (24 hex characters, no dashes)
4848
4949
Getting Started:
50-
1. Call get_device_documentation tool for detailed reference guides
50+
1. Read device-attributes MCP resource for detailed attribute/command reference
5151
2. Use get_device_state to discover device capabilities and current values
5252
3. For common actions: control_device_simple (turn_on, set_brightness, etc.)
5353
4. For precise control: control_device with specific attribute elementIds

src/resources/definitions/control-guide.resource.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ export const CONTROL_GUIDE_RESOURCE = {
1313
uri: 'rogo://docs/control-guide',
1414
name: 'Device Control Guide',
1515
description:
16-
'[Manual Reference] Step-by-step guide for controlling devices: how to get device info, determine commands, and verify results. For AI-accessible docs, use get_device_documentation tool instead.',
16+
'[Manual Reference] Step-by-step guide for controlling devices: how to get device info, determine commands, and verify results.',
1717
mimeType: 'text/markdown',
1818

1919
async read(): Promise<string> {

src/resources/definitions/device-attributes.resource.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ export const DEVICE_ATTRIBUTES_RESOURCE = {
1515
uri: 'rogo://docs/device-attributes',
1616
name: 'Device Attributes Reference',
1717
description:
18-
'[Manual Reference] Complete reference of device types, attributes, commands, and value ranges. For AI-accessible docs, use get_device_documentation tool instead.',
18+
'[Manual Reference] Complete reference of device types, attributes, commands, and value ranges.',
1919
mimeType: 'text/markdown',
2020

2121
/**

src/resources/definitions/overview.resource.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ export const OVERVIEW_RESOURCE = {
1616
uri: 'rogo://docs/overview',
1717
name: 'IoT MCP Overview',
1818
description:
19-
'[Manual Reference] Introduction to the IoT Cloud MCP Bridge: system architecture, core concepts (device/element/attribute/state), field definitions (uuid/eid/rootUuid), and quick reference. For AI-accessible docs, use get_device_documentation tool instead.',
19+
'[Manual Reference] Introduction to the IoT Cloud MCP Bridge: system architecture, core concepts (device/element/attribute/state), field definitions (uuid/eid/rootUuid), and quick reference.',
2020
mimeType: 'text/markdown',
2121

2222
/**

src/resources/definitions/state-guide.resource.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ export const STATE_GUIDE_RESOURCE = {
1313
uri: 'rogo://docs/state-guide',
1414
name: 'Device State Guide',
1515
description:
16-
'[Manual Reference] Complete guide for reading device state: structure explanation, real examples, and how to use state for verification and capability discovery. For AI-accessible docs, use get_device_documentation tool instead.',
16+
'[Manual Reference] Complete guide for reading device state: structure explanation, real examples, and how to use state for verification and capability discovery.',
1717
mimeType: 'text/markdown',
1818

1919
async read(): Promise<string> {

src/tools/definitions/control-device.tool.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ export type ControlDeviceParams = z.infer<typeof ControlDeviceParamsSchema>;
4141
export const CONTROL_DEVICE_TOOL = {
4242
name: 'control_device',
4343
description:
44-
'Control IoT devices by UUID, element IDs, and commands. Elements are physical parts (e.g., 4-button switch has 4 elements). Command format: [attrId, value]. Common attrs: 1=ON_OFF (0/1), 28=BRIGHTNESS (0-1000), 29=KELVIN, 20=TEMP_SET (15-30°C), 17=MODE. Call get_device_documentation for full reference.',
44+
'Control IoT devices by UUID, element IDs, and commands. Elements are physical parts (e.g., 4-button switch has 4 elements). Command format: [attrId, value]. Common attrs: 1=ON_OFF (0/1), 28=BRIGHTNESS (0-1000), 29=KELVIN, 20=TEMP_SET (15-30°C), 17=MODE. See device-attributes resource for full reference.',
4545
inputSchema: {
4646
type: 'object' as const,
4747
properties: {
@@ -65,7 +65,7 @@ export const CONTROL_DEVICE_TOOL = {
6565
metadata: {
6666
name: 'control_device',
6767
description:
68-
'Control IoT devices by UUID, element IDs, and commands. Elements are physical parts (e.g., 4-button switch has 4 elements). Command format: [attrId, value]. Common attrs: 1=ON_OFF (0/1), 28=BRIGHTNESS (0-1000), 29=KELVIN, 20=TEMP_SET (15-30°C), 17=MODE. Call get_device_documentation for full reference.',
68+
'Control IoT devices by UUID, element IDs, and commands. Elements are physical parts (e.g., 4-button switch has 4 elements). Command format: [attrId, value]. Common attrs: 1=ON_OFF (0/1), 28=BRIGHTNESS (0-1000), 29=KELVIN, 20=TEMP_SET (15-30°C), 17=MODE. See device-attributes resource for full reference.',
6969
examples: [
7070
{
7171
input: {

src/tools/definitions/get-device-documentation.tool.ts

Lines changed: 0 additions & 91 deletions
This file was deleted.

src/tools/services/tool-registry.service.ts

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,6 @@ import { GET_LOCATION_STATE_TOOL } from '../definitions/get-location-state.tool'
2121
import { GET_DEVICE_STATE_BY_MAC_TOOL } from '../definitions/get-device-state-by-mac.tool';
2222
import { CONTROL_DEVICE_TOOL } from '../definitions/control-device.tool';
2323
import { CONTROL_DEVICE_SIMPLE_TOOL } from '../definitions/control-device-simple.tool';
24-
import { GET_DEVICE_DOCUMENTATION_TOOL } from '../definitions/get-device-documentation.tool';
2524
import { WIDGET_LIST_DEVICES_TOOL } from '../definitions/widget-list-devices.tool';
2625
import { WIDGET_GET_DEVICE_TOOL } from '../definitions/widget-get-device.tool';
2726
import { WIDGET_CONTROL_DEVICE_TOOL } from '../definitions/widget-control-device.tool';
@@ -42,7 +41,6 @@ const ALL_TOOL_DEFINITIONS = [
4241
GET_DEVICE_STATE_BY_MAC_TOOL,
4342
CONTROL_DEVICE_TOOL,
4443
CONTROL_DEVICE_SIMPLE_TOOL,
45-
GET_DEVICE_DOCUMENTATION_TOOL,
4644
WIDGET_LIST_DEVICES_TOOL,
4745
WIDGET_GET_DEVICE_TOOL,
4846
WIDGET_CONTROL_DEVICE_TOOL,

0 commit comments

Comments
 (0)