MindResetデバイスとやり取りするためのツールを提供するモデルコンテキストプロトコル(MCP)サーバー。 このサーバーは、MindResetデバイス画面にテキストや画像を表示するための公式のMindReset APIエンドポイントを実行します。

##特徴

• 簡単なテキストAPI: MindReset デバイスの基本的なテキストコンテンツを表示する
• 複雑なテキストAPI: 署名とフォーマットでテキストを表示
• アイコン付きテキスト:カスタムアイコンとタップツージャンプリンクでテキストコンテンツを表示
• イメージAPI: カスタマイズ可能な境界線でPNG画像を表示

前提条件

• Node.js >= 18 ノード
• APIアクセスのマインドリセットデバイス
• MindResetアプリからデバイスIDとシークレット

インストール

1. 本リポジトリのクローンまたはダウンロード

2. 依存関係を取付けて下さい:

3. プロジェクトのビルド:

設定

必要な環境変数を設定します。

MindReset API の公式ドキュメントに従って、MindReset App からこれらの資格情報を得ることができます。

使用法

###開発モード

生産モード

利用可能なツール

マインドリセット simple text

MindResetデバイス画面に簡単なテキストコンテンツを送信します。

パラメーター:

• [deviceId(必須):デバイスシリアル番号
• title: テキストタイトル

MindReset MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with MindReset devices. This server implements the official MindReset API endpoints for displaying text and images on MindReset device screens.

Features

• Simple Text API: Display basic text content on MindReset devices
• Complex Text API: Display text with signatures and formatting
• Text with Icons: Display text content with custom icons and tap-to-jump links
• Image API: Display PNG images with customizable borders

Prerequisites

• Node.js >= 18
• A MindReset device with API access
• Device ID and Secret from MindReset App

Installation

1. Clone or download this repository

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Configuration

Set the required environment variables:

export MINDRESET_DEVICE_ID="your_device_serial_number"
export MINDRESET_DEVICE_SECRET="your_device_secret"

You can obtain these credentials from the MindReset App by following the official MindReset API documentation.

Usage

Development Mode

npm run dev

Production Mode

npm start

Available Tools

mindreset_simple_text

Send simple text content to a MindReset device screen.

Parameters:

• deviceId (required): Device serial number
• title (optional): Text title
• message (required): Text content to display

Example:

{
  "deviceId": "ABCD1234ABCD",
  "title": "Hello World",
  "message": "I can swallow glass without harming myself"
}

mindreset_complex_text

Send complex text content with signature to a MindReset device screen.

Parameters:

• deviceId (required): Device serial number
• title (optional): Text title
• message (required): Text content to display
• signature (optional): Text signature/footer

Example:

{
  "deviceId": "ABCD1234ABCD",
  "title": "Verification Code Helper",
  "message": "A verification code from 'Shao Pai'\n205112",
  "signature": "August 4, 2025 19:58"
}

mindreset_text_with_icon

Send text content with icon and optional link to a MindReset device screen.

Parameters:

• deviceId (required): Device serial number
• title (optional): Text title
• message (required): Text content to display
• signature (optional): Text signature/footer
• icon (optional): Base64 encoded PNG icon data (40px*40px)
• link (optional): HTTP/HTTPS link or Scheme URL for tap-to-jump

Example:

{
  "deviceId": "ABCD1234ABCD",
  "title": "Daily Health",
  "message": "Calories burned: 702 kcal\nSteps today: 4183\nStanding time: 62 minutes",
  "signature": "August 4, 2025 20:16",
  "icon": "iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAA...",
  "link": "x-apple-health://"
}

mindreset_image

Display PNG image on a MindReset device screen.