Dot MCP
Enables AI assistants to send text notifications with titles, messages, signatures, icons, and links to Dot e-ink display devices. Supports immediate or scheduled display for proactive AI-to-user notifications.
README
Dot MCP - Send Notifications to Your Dot E-ink Device
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
推荐服务器
Baidu Map
百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
VeyraX
一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Kagi MCP Server
一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。
e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。