Action MCP Server

This is an MCP server that controls video playback on client devices via EMQX (MQTT).

Features

• play_video: Sends a command to play a specific video.
• stop_video: Sends a command to stop video playback.

Prerequisites

• Node.js >= 18
• Docker & Docker Compose (for running EMQX locally)

Quick Start with EMQX

1. Start the EMQX broker:

   docker-compose up -d

   This will start EMQX with the default credentials admin / public, which matches the default .env configuration.

2. Install dependencies and build:

   npm install
   npm run build

3. Run the MCP Inspector to test:

   npm run inspector

Configuration

1. Copy .env file (created automatically) and update the values:

   EMQX_API_URL=http://localhost:18083/api/v5/publish
   EMQX_APP_ID=admin
   EMQX_APP_SECRET=public

Installation

npm install
npm run build

Usage

Running the Server

npm start

Integration with Claude Desktop or other MCP Clients

Add the following configuration to your MCP client settings:

{
  "mcpServers": {
    "video-control": {
      "command": "node",
      "args": ["/path/to/action-mcp/dist/index.js"],
      "env": {
        "EMQX_API_URL": "http://localhost:18083/api/v5/publish",
        "EMQX_APP_ID": "admin",
        "EMQX_APP_SECRET": "public"
      }
    }
  }
}

Development

npm run dev