Quote0 Mcp

Name: Quote0 Mcp
Author: thomaszdxsn

本地服务

github.com/thomaszdxsn其他355 周前更新

代码仓库

关于 Quote0 Mcp

Quote0 MCP 服务让 Claude Desktop 通过自然语言向 Quote0 电子墨水屏设备发送文字和图片。它支持为多个设备设置别名，也可配置自定义 API 地址。

主要功能

01向设备发送文字
02向设备发送 PNG 图片
03通过别名选择多个设备
04支持自定义 API 地址

适用场景

01在电子墨水屏显示待办或天气
02发送名言、图片或二维码
03向指定设备发送带链接的图片

MCP 相关

它作为 MCP 服务接入 Claude Desktop，提供对 Quote0 设备发送文字和图片的能力。

#quote0 #smart-display #device-control

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "quote0": {
      "command": "npx",
      "args": [
        "-y",
        "quote0-mcp"
      ],
      "env": {
        "QUOTE0_API_KEY": "<QUOTE0_API_KEY>",
        "QUOTE0_DEVICE_IDS": "<QUOTE0_DEVICE_IDS>"
      }
    }
  }
}

启动命令npx -y quote0-mcp

需要配置的环境变量

QUOTE0_API_KEY密钥

QUOTE0_DEVICE_IDS

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmquote0-mcpstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
device	string	是	设备名称或序列号。可用设备："书桌"、"客厅"、"冰箱"
title	string	否	文本标题——在设备上显示为消息的标题
message	string	否	文本内容——要显示的消息正文
signature	string	否	文本署名——显示在消息底部，通常用于注明作者
icon	string	否	Base64 编码的 PNG 图标（40px*40px）——与消息一起显示，用于视觉识别
link	string	否	HTTP/HTTPS URL 或 Scheme URL——用户点击消息时打开此链接
refreshNow	boolean	否	是否立即在设备上显示内容（默认：true）

详细介绍

来自项目 README

Quote0 MCP

通过 Claude Desktop 控制您的 Quote0 智能显示设备。

什么是 Quote0？

Quote0 是一款智能电子墨水屏显示设备，可以远程更新显示内容。通过这个 MCP 服务，您可以在 Claude Desktop 中用自然语言控制设备，发送文字和图片。

准备工作

使用前您需要：

API Key：从 Quote0 App 获取 - 查看教程
设备序列号：在设备背面或 App 中查看 - 查看教程

快速开始

在 Claude Desktop 中配置

找到配置文件
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
添加 Quote0 MCP 配置

{
  "mcpServers": {
    "quote0": {
      "command": "npx",
      "args": ["quote0-mcp"],
      "env": {
        "QUOTE0_API_KEY": "你的API密钥",
        "QUOTE0_DEVICE_IDS": "书桌:设备序列号1,客厅:设备序列号2,冰箱:设备序列号3"
      }
    }
  }
}

配置说明：

QUOTE0_API_KEY：必填，您的 API 密钥
QUOTE0_DEVICE_IDS：可选，给设备起别名，格式为 别名:序列号，多个设备用逗号分隔

重启 Claude Desktop

使用示例

配置完成后，您可以在 Claude Desktop 中这样对话：

📝 发送文字

示例 1：发送待办事项

请发送以下内容到书桌的设备：
标题：今日待办
内容：
1. 完成项目报告
2. 下午3点会议  
3. 回复重要邮件
署名：2024年1月15日

示例 2：显示名言警句

在客厅设备上显示：
"书山有路勤为径，学海无涯苦作舟"
署名：古训

示例 3：显示天气信息

帮我在玄关的 Quote0 上显示：
标题：今日天气
内容：晴，15-22°C
备注：适合外出

🖼️ 发送图片

示例 1：发送本地图片

把这张图片发送到卧室的设备上
[附上图片文件]

示例 2：生成并发送二维码

生成我的 WiFi 信息二维码，发送到客厅设备：
网络名：MyHome
密码：12345678

示例 3：发送带链接的图片

发送公司 logo 到书桌设备，点击后打开公司官网 https://example.com

设备别名配置

为了方便使用，建议给每个设备起一个容易记住的别名：

按位置命名

"QUOTE0_DEVICE_IDS": "书桌:abc123,客厅:def456,卧室:ghi789,厨房:jkl012"

按用途命名

"QUOTE0_DEVICE_IDS": "日程表:abc123,相框:def456,便签:ghi789"

支持中文或英文

"QUOTE0_DEVICE_IDS": "desk:abc123,living_room:def456,冰箱:ghi789,玄关:jkl012"

高级配置

自定义 API 地址（可选）

如果您使用私有部署的 Quote0 服务：

{
  "mcpServers": {
    "quote0": {
      "command": "npx",
      "args": ["quote0-mcp"],
      "env": {
        "QUOTE0_API_KEY": "你的API密钥",
        "QUOTE0_TEXT_API_URL": "https://your-server.com/api/open/text",
        "QUOTE0_IMAGE_API_URL": "https://your-server.com/api/open/image",
        "QUOTE0_DEVICE_IDS": "设备1:id1,设备2:id2"
      }
    }
  }
}

本地开发模式

如果您想修改或扩展功能：

克隆代码仓库

git clone https://github.com/your-username/quote0-mcp.git
cd quote0-mcp

安装依赖并编译

pnpm install
pnpm build

在 Claude Desktop 中使用本地版本

{
  "mcpServers": {
    "quote0-local": {
      "command": "node",
      "args": ["/完整路径/quote0-mcp/dist/index.js"]
    }
  }
}

常见问题

Q: 设备没有响应？

A: 请检查：

设备是否开机并连接网络
API Key 是否正确
设备序列号是否正确

Q: 如何知道命令是否成功？

A: Claude 会告诉您发送结果，成功时会显示"Successfully sent"，失败时会说明原因。

Q: 可以同时控制多个设备吗？

A: 可以，只需在配置中添加多个设备的序列号和别名即可。

Q: 图片显示效果不好？

A: Quote0 使用电子墨水屏，建议使用：

黑白或灰度图片
简单清晰的图形
避免过于复杂的渐变

注意事项

API 限制：每秒最多发送 1 次请求
设备需要保持开机状态并连接 WiFi
图片格式必须是 PNG，会自动转换为 Base64
文字内容支持中英文和 Emoji

开源协议

MIT License

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。