WoT-MCP CLI

An interactive Command Line Interface (CLI) client for the WoT-MCP server. This tool allows you to connect to the MCP server, inspect available tools and resources, and interact with Web of Things devices through the Model Context Protocol.

Features

• Interactive Shell: Type commands to interact with the server.
• Transport Modes: Supports both stdio (spawning the server directly) and streamable-http (connecting to a running server).
• Tool Inspection: List available tools and their schemas.
• Tool Execution: Call tools with JSON arguments.
• Resource Management: List, read, and subscribe to resources.

Installation

git clone https://github.com/macc-n/wot-mcp-cli.git
cd wot-mcp-cli
npm install
npm run build

Usage

Stdio (Default)

This mode spawns the wot-mcp server as a subprocess. You need to provide the configuration file for the server.

Note: This mode assumes that wot-mcp-cli and wot-mcp are located in the same parent directory (i.e., ../wot-mcp/dist/main.js must exist).

npm start -- --config ./things-config.json

Streamable HTTP

Connect to an existing wot-mcp server running in streamable-http mode.

1. Start the WoT-MCP server first:

   cd wot-mcp
   npm start -- --mode streamable-http --port 3000 --config ./things-config.json
   

2. Connect the CLI:

   npm start -- --mode streamable-http --url http://localhost:3000/mcp
   

Commands

Once inside the interactive shell, you can use the following commands:

Command	Description	Example
tools	List all available tools	tools
call <tool> [json]	Call a tool with arguments	call set_temperature {"value": 22}
resources	List all available resources	resources
read <uri>	Read a resource by URI	read wot://device/properties/temp
subscribe <uri>	Subscribe to resource updates	subscribe wot://device/events/overheat
unsubscribe <uri>	Unsubscribe from updates	unsubscribe wot://device/events/overheat
help	Show help message	help
exit	Exit the CLI	exit