adolforeyna/mac_mcp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sync from Mac mini main: preserve full-app-path fix (/System/Applications/), reminders assignment hints, deco_ha_bridge for clients, plus image tools, plus system speech API check

Browse Source 
Mac mini is on macOS 26.5.2 Mac16,10 M4 - SpeechAnalyzer available
- Calendar/Contacts/Notes/Reminders use full /System/Applications/*.app path (more reliable)
- Reminders now returns assignment {assignee, source, available} with fallback to (Name) in title
- deco.js uses deco_ha_bridge.py for clients action (more reliable than old bridge)
- Added deco_ha_bridge.py (13KB RSA/AES Deco HA client)
- Added system_get_info + system_speech_api_status (verifies SpeechAnalyzer on macOS 26+)
- Preserved codex-image, gemini-image, gemini-chrome-prompt tools
- Updated README with all 23 tools + macOS 26 note + benchmark ref
This commit is contained in:
aeroreyna
2026-07-13 16:18:40 -04:00
parent 4bed6145b9
commit 2345627eb8
7 changed files with 544 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+52 -7
View File
@@ -14,17 +14,25 @@ and stays on the local machine.
| `calendar_list_calendars` | List calendar indexes, names, and write capability |
| `calendar_list_events` | List events in an ISO-8601 time window from the focused `Home` calendar |
| `calendar_create_event` | Create an event in the focused `Home` calendar |
| `reminders_list_lists` | List reminder lists |
| `reminders_list` | List reminders |
| `reminders_list_lists` | List reminder lists with account context and assignment metadata availability |
| `reminders_list` | List reminders, including assignment details or assignment hints for shared-list reminders |
| `reminders_create` | Create a reminder |
| `contacts_search` | Search contact names and organizations without disclosing contact methods |
| `contacts_read` | Read phone and email details for one selected contact |
| `contacts_create` | Create a contact with optional email and phone details |
| `deco_get_config_status` | Show Deco connection config without revealing the password |
| `deco_get_overview` | Read TP-Link Deco overview stats and firmware |
| `deco_list_clients` | List online Deco clients and current traffic speeds |
| `deco_list_clients` | List online Deco clients, current traffic speeds, and linked mesh node when available |
| `deco_get_ipv4_status` | Read WAN/LAN IPv4 status |
| `deco_get_firmware` | Read Deco model and firmware version |
| `system_get_info` | Get macOS version (sw_vers), hardware model, and SpeechAnalyzer availability |
| `system_speech_api_status` | Full check for Apple SpeechAnalyzer/SpeechTranscriber (macOS 26+) |
| `codex_image_get_config_status` | Show local Codex CLI image generation config |
| `codex_image_generate` | Generate an image with this Mac's Codex CLI and save it locally |
| `gemini_image_get_config_status` | Show Gemini image generation config without revealing the API key |
| `gemini_image_generate` | Generate an image with the Gemini API and save it locally |
| `gemini_chrome_prompt_get_config_status` | Show config for the Codex Chrome-skill Gemini image prompt builder |
| `gemini_chrome_prompt_build` | Build a ready-to-run Codex prompt for Gemini web-app image generation |
There are no destructive tools in the initial server.
@@ -33,6 +41,16 @@ event-rich `Home` calendar discovered during setup (`calendarIndex: 2`) and
verifies the selected index is still named `Home` before operating on it.
Calendar selector parameters remain available as advanced overrides.
Reminder assignment data is exposed on `reminders_list` as an `assignment`
object. Apple Reminders automation does not currently publish shared-list
participant metadata directly, so the tool first checks for any native assignee
field macOS exposes and then falls back to assignment hints embedded in the
reminder title or notes, such as `(Alicia)` or `Captured 2026-05-18, Alicia;`.
**macOS 26 note:** This Mac is on macOS 26.5.2 (Mac16,10 M4) — so `system_speech_api_status`
confirms SpeechAnalyzer/SpeechTranscriber is available. Apple's new engine beats Whisper
Small 2.12% vs 3.74% WER per Inscribe benchmark (2026-07-13).
## Setup
Requires macOS and Node.js 20 or newer.
@@ -86,7 +104,7 @@ For a trusted local-network harness such as a Raspberry Pi, set
```text
URL: http://<mac-lan-ip>:7331/mcp
Authorization: Bearer <MACMINI_MCP_TOKEN>
Authorization: Bearer <MACMI...KEN>
```
Restart after changing `.env`:
@@ -96,8 +114,28 @@ npm run service:restart
```
For TP-Link Deco tools, install Python dependencies with `npm run
python:install`, then set `DECO_HOST`, `DECO_USERNAME`, `DECO_PASSWORD`, and
optionally `DECO_VERIFY_SSL=false` in `.env`.
python:install`, then set `DECO_HOST`, `DECO_USERNAME=admin`, `DECO_PASSWORD`,
and optionally `DECO_VERIFY_SSL=false` in `.env`.
For Codex image generation, make sure the Mac is logged in with `codex login`.
Generated files are saved to `generated-images/` by default; override this with
`CODEX_IMAGE_OUTPUT_DIR`. Set `CODEX_IMAGE_MODEL` or `CODEX_IMAGE_TIMEOUT_MS` or
`CODEX_CLI_PATH` to the absolute `codex` path.
For Gemini image generation, set `GEMINI_API_KEY` in `.env`. Generated files are
saved to `generated-images/` by default; override this with
`GEMINI_IMAGE_OUTPUT_DIR`. The Gemini image tool calls the Gemini API directly
and does not expose browser navigation, page inspection, or screenshot tools.
For Gemini image generation through the signed-in Chrome web app, use
`gemini_chrome_prompt_build` to create a ready-to-run Codex prompt. The MCP
service does not control Chrome directly; the Chrome skill is only available
inside an active Codex session. The generated prompt verifies the Chrome profile
name is `ReynaFamilyBot`, opens only `https://gemini.google.com/app`, submits the
image prompt, downloads the generated image, and copies it to
`generated-images/`. Override the expected Chrome profile with
`GEMINI_CHROME_PROFILE_NAME` and the output directory with
`GEMINI_CHROME_IMAGE_OUTPUT_DIR`.
For a harness that launches stdio servers, use:
@@ -120,7 +158,7 @@ to control under **System Settings > Privacy & Security > Automation**.
The HTTP service binds to `127.0.0.1` by default. When configured to bind to a
LAN address, it refuses to start without `MACMINI_MCP_TOKEN`; clients must send
`Authorization: Bearer <token>`. This is HTTP bearer authentication on your
`Authorization: Bearer *** This is HTTP bearer authentication on your
local network, not encrypted transport. Use it only on a trusted LAN or put it
behind a private encrypted network such as a VPN.
@@ -133,3 +171,10 @@ npm run dev
The MCP transport follows the official TypeScript SDK Streamable HTTP server
approach: [Model Context Protocol TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk).
## Image generation
This server exposes Codex-backed and Gemini-backed image generation tools.
Gemini image generation uses the Gemini API directly, not browser automation.
Image Playground was tried and removed because the macOS app does not expose a
scriptable prompt-to-file action through AppleScript or Shortcuts/App Intents.