Dot MCP - Send Notifications to Your Dot E-ink Device

English | 中文

English

Introduction

Dot MCP is a Model Context Protocol (MCP) server that enables AI assistants to send notifications to your Dot e-ink display device. When AI completes tasks, encounters issues, or needs your attention, it can proactively notify you through your Dot device.

Features

• Send text notifications to Dot e-ink device
• Support for title, message, signature, icon, and link
• Immediate refresh or scheduled display
• Proactive notifications from AI assistants

Requirements

• Node.js >= v18.0.0
• A Dot device, API key and Device ID (How to get API key and Device ID)
• An MCP-compatible client (Cursor, Claude Code, VS Code, Windsurf, etc.)

Installation

Install in Cursor

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Add the following configuration to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Install in Claude Code

Run this command:

claude mcp add dot -- npx -y mindreset-dot-mcp --api-key YOUR_API_KEY --device-id YOUR_DEVICE_ID

Install in VS Code

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

{
  "mcp": {
    "servers": {
      "dot": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mindreset-dot-mcp",
          "--api-key",
          "YOUR_API_KEY",
          "--device-id",
          "YOUR_DEVICE_ID"
        ]
      }
    }
  }
}

Install in Windsurf

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Install in Cline

Open Cline MCP settings and add the following configuration:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Install in Claude Desktop

Open Claude Desktop developer settings and edit your claude_desktop_config.json:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Using Environment Variables

You can also use environment variables instead of CLI arguments:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": ["-y", "mindreset-dot-mcp"],
      "env": {
        "DOT_API_KEY": "YOUR_API_KEY",
        "DOT_DEVICE_ID": "YOUR_DEVICE_ID"
      }
    }
  }
}

Available Tool

send_text

Send text content to your Dot e-ink device.

Parameters:

| Parameter | Type | Required | Description | | ---------- | ------- | -------- | -------------------------------------------------------------------- | | title | string | No | Text title displayed on the screen (max 10 Chinese characters) | | message | string | No | Text content displayed on the screen (max 40 Chinese characters) | | signature | string | No | Text signature displayed on the screen | | icon | string | No | Base64 encoded PNG icon data (40x40px), displayed in the bottom left | | link | string | No | HTTP/HTTPS link or Scheme URL for tap-to-open functionality | | refreshNow | boolean | No | Whether to display content immediately (default: true) |

Development

# Install dependencies
pnpm install

# Build
pnpm run build

# Run tests
pnpm run test

License

MIT

中文

简介

Dot MCP 是一个 Model Context Protocol (MCP) 服务器，可以让 AI 助手向你的 Dot 墨水屏设备发送通知。当 AI 完成任务、遇到问题或需要你的注意时，它可以主动通过你的 Dot 设备通知你。

功能特性

• 向 Dot 墨水屏设备发送文本通知
• 支持标题、消息、签名、图标和链接
• 即时刷新或定时显示
• AI 助手主动通知

系统要求

• Node.js >= v18.0.0
• Dot 设备、API 密钥和设备 ID（如何获取 API 密钥和设备 ID）
• 支持 MCP 的客户端（Cursor、Claude Code、VS Code、Windsurf 等）

安装配置

在 Cursor 中安装

进入: Settings -> Cursor Settings -> MCP -> Add new global MCP server

在 ~/.cursor/mcp.json 中添加以下配置：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

在 Claude Code 中安装

运行以下命令：

claude mcp add dot -- npx -y mindreset-dot-mcp --api-key 你的API密钥 --device-id 你的设备ID

在 VS Code 中安装

将以下配置添加到 VS Code MCP 配置文件中。详见 VS Code MCP 文档。

{
  "mcp": {
    "servers": {
      "dot": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mindreset-dot-mcp",
          "--api-key",
          "你的API密钥",
          "--device-id",
          "你的设备ID"
        ]
      }
    }
  }
}

在 Windsurf 中安装

将以下配置添加到 Windsurf MCP 配置文件中。详见 Windsurf MCP 文档。

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

在 Cline 中安装

打开 Cline MCP 设置并添加以下配置：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

在 Claude Desktop 中安装

打开 Claude Desktop 开发者设置并编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

使用环境变量

你也可以使用环境变量代替命令行参数：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": ["-y", "mindreset-dot-mcp"],
      "env": {
        "DOT_API_KEY": "你的API密钥",
        "DOT_DEVICE_ID": "你的设备ID"
      }
    }
  }
}

可用工具

send_text

向 Dot 墨水屏设备发送文本内容。

参数：

| 参数 | 类型 | 必填 | 描述 | | ---------- | ------- | ---- | -------------------------------------------------- | | title | string | 否 | 屏幕上显示的标题（最多 10 个中文字符显示长度） | | message | string | 否 | 屏幕上显示的内容（最多 40 个中文字符显示长度） | | signature | string | 否 | 屏幕上显示的签名 | | icon | string | 否 | Base64 编码的 PNG 图标（40x40 像素），显示在左下角 | | link | string | 否 | HTTP/HTTPS 链接或 Scheme URL，点击可打开 | | refreshNow | boolean | 否 | 是否立即显示内容（默认：true） |

开发

# 安装依赖
pnpm install

# 构建
pnpm run build

# 运行测试
pnpm run test

许可证

MIT