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