mcp-typescript-sdk

Overview

This is a comprehensive TypeScript SDK for implementing the Model Context Protocol (MCP) over MQTT. It provides a clean, object-oriented API with proper TypeScript classes for creating both MCP servers and clients. The SDK supports automatic environment detection between browser (WebSocket) and Node.js (TCP) environments, ensuring seamless cross-platform functionality. It includes full type safety with Zod schema validation, automatic server discovery, and follows the MCP specification v2024-11-05.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• greet({ name: string, language?: 'en' | 'es' | 'fr' }) => Promise<{ content: Array<{ type: 'text', text: string }> }>

  Greet someone with a personalized message

  Try:Hello thereTry:Greet John in SpanishTry:Say hi to Alice in French
• calculate({ expression: string }) => Promise<{ content: Array<{ type: 'text', text: string }>, isError?: boolean }>

  Perform mathematical calculations

  Try:Calculate 2+2Try:Solve 5*3-2Try:Evaluate 10/2

Comparable tools

Installation

npm install @emqx-ai/mcp-mqtt-sdk

{
  "mcpServers": {
    "mqtt-mcp": {
      "command": "npx",
      "args": ["@emqx-ai/mcp-mqtt-sdk"],
      "env": {
        "MQTT_HOST": "mqtt://localhost:1883"
      }
    }
  }
}

FAQ

What MQTT brokers are supported?

The SDK supports any standard MQTT broker including EMQX, Mosquitto, HiveMQ, and others. You can connect via mqtt:// for TCP or ws://wss:// for WebSocket connections.

Does this work in browser environments?

Yes, the SDK automatically detects browser environments and uses WebSocket connections instead of TCP. It works seamlessly in both Node.js and browser contexts.

On Hacker News

Recent discussion from the developer community.

• TypeScript MCP-MQTT SDK: Extending AI Agents from Web to IoT and Edge▲ 1💬 1
  Story by Kiplingbt · 2025-09-15

Compare mcp-typescript-sdk with