mattt/iMCP

A macOS app that provides an MCP server to your Messages, Contacts, Reminders and more

iMCP – 您的個人資料與 AI 工具之間的 macOS 橋樑

這是什麼 – iMCP 是一款原生 macOS 應用程式（內建 imcp‑server 命令列工具），實作了 Model Context Protocol (MCP)。它公開了一組「工具」 – 行事曆、聯絡人、位置、地圖、訊息、提醒事項、天氣 – 可由相容於 MCP 的 AI 客戶端呼叫，例如 Claude Desktop、Claude Code、Cursor 和 Amp。AI 可以請求例如「我所在位置的天氣如何？」，iMCP 將從作業系統取得資料，並以結構化的 JSON‑LD 格式傳回。

核心功能

服務	您可以做什麼
Calendar	列出事件、建立新事件（重複性、鬧鐘、可用性）。
Contacts	讀取您自己的聯絡人名片，並依姓名、電話或電子郵件搜尋聯絡人。
Location	取得目前的地理座標，或將地址與座標互相轉換。
Maps	搜尋地點、取得路線、查詢景點、估計旅行時間、產生靜態地圖影像。
Messages	擷取指定參與者在特定日期範圍內的訊息歷史記錄。
Reminders	列出提醒事項，並建立具有到期日、優先順序和提醒的新提醒事項。
Weather	取得任何位置目前的溫度、風速和天氣狀況。

運作方式

MCP 伺服器 – 內建的 imcp‑server 作為本地 TCP 服務執行（透過 Bonjour 的 _mcp._tcp）。它透過 stdio 傳輸 (stdin/stdout) 與 AI 客戶端通訊，並將請求轉發給 GUI 應用程式。
權限處理 – macOS 應用程式會在您第一次啟用服務時要求標準系統權限（行事曆、聯絡人等）。iMCP 本身不會儲存或傳送任何資料；只有您連接的 AI 客戶端（例如 Claude）可以傳輸資料。
工具回應 – 每個工具都會傳回使用 schema.org 詞彙的 JSON‑LD 文件（例如，聯絡人使用 Person 物件）。這種格式易於人類和 LLM 使用。
客戶端整合 – 安裝 iMCP 後，將其新增至客戶端：
- Claude Desktop – 使用 Configure Claude Desktop 選單項目，或將伺服器命令複製到 claude_desktop_config.json。
- Claude Code – claude mcp add --scope user iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server。
- Cursor – 點擊提供的深層連結，它會自動安裝伺服器命令。
- Amp – amp mcp add iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server。
除錯 – 專案隨附 MCP Inspector (Node.js) 和 macOS Companion 應用程式，以檢視請求/回應串流並測試伺服器。

開始使用（快速步驟）

安裝 – brew install --cask mattt/tap/iMCP 或從 https://iMCP.app/download 下載（需要 macOS 15.3+）。
啟動 – 選單列中會出現一個圖示；切換藍色開關以啟動 MCP 伺服器。
啟用服務 – 點擊服務圖示，授予 macOS 權限對話框，圖示就會變更顏色（紅色 = 行事曆，綠色 = 訊息等）。
連接客戶端 – 遵循上述特定客戶端的指示；在客戶端核准連線後，您會在聊天 UI 中看到一個鐵鎚 (🔨) 圖示，表示工具已可用。
詢問 AI – 提出需要個人資料的自然語言請求；AI 將呼叫適當的 iMCP 工具並傳回結果。

技術亮點

Swift SDK – iMCP 使用 Model Context Protocol 的官方 Swift SDK (https://github.com/modelcontextprotocol/swift-sdk)。
訊息資料庫存取 – 透過自訂的 Madrid Swift 套件，從 ~/Library/Messages/chat.db 讀取 macOS 訊息，該套件能解碼 Apple 專有的 typedstream 格式。
JSON‑LD 本體論 – Ontology Swift 套件提供輔助程式，將 Apple 框架物件（例如 CNContact）編碼為 schema.org JSON‑LD。
本地探索 – Bonjour 廣播讓任何相容於 MCP 的客戶端都能找到伺服器，無需手動設定。

誰可能會使用它？

進階使用者，希望他們的 LLM 助理能對真實的個人資料採取行動（安排會議、擷取最新訊息、查看天氣），而無需手動複製資訊。
開發人員，正在建構新的 MCP 客戶端或自訂工具 – iMCP 可作為參考實作和現成的資料來源。
注重隱私的使用者 – iMCP 本身絕不儲存或傳送資料；所有資料流程都透過 macOS 權限由使用者控制。

授權與法律

MIT 授權。
不隸屬於 Apple；iMessage® 是 Apple Inc. 的商標。

總結： iMCP 是一個真正可用於生產環境的 macOS 橋樑，讓現代 AI 助理能夠透過標準協定安全地在本地查詢您的個人 macOS 資料，使 AI 驅動的個人生產力成為可能，同時兼顧隱私。