@heznpc/imcp 0.7.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +47 -1
- package/README.md +47 -1
- package/dist/index.js +1 -1
- package/package.json +2 -1
package/README.ko.md
CHANGED
|
@@ -13,7 +13,8 @@ Apple 생태계 전체를 위한 MCP 서버 — Notes, Reminders, Calendar, Cont
|
|
|
13
13
|
- **반복 이벤트/리마인더** — EventKit으로 반복 규칙 생성 (macOS 26+ Swift 브릿지)
|
|
14
14
|
- **사진 가져오기/삭제** — PhotoKit으로 사진 관리 (macOS 26+ Swift 브릿지)
|
|
15
15
|
- **Apple Intelligence** — 온디바이스 요약, 재작성, 교정 (macOS 26+)
|
|
16
|
-
-
|
|
16
|
+
- **네이티브 메뉴바 앱** — SwiftUI 컴패니언 앱으로 상태 모니터링, 권한 설정, 설정 복사
|
|
17
|
+
- **원클릭 셋업** — `setup_permissions` 도구 또는 메뉴바 앱으로 모든 macOS 권한을 한번에 요청
|
|
17
18
|
- **stdio 전송** — 안전한 로컬 통신, 네트워크 노출 없음
|
|
18
19
|
- **Safety Annotations** — 모든 도구에 readOnly/destructive 힌트 적용
|
|
19
20
|
|
|
@@ -49,6 +50,17 @@ npm install
|
|
|
49
50
|
npm run build
|
|
50
51
|
```
|
|
51
52
|
|
|
53
|
+
### 메뉴바 앱 (선택)
|
|
54
|
+
|
|
55
|
+
서버 상태 모니터링과 권한 설정을 위한 네이티브 SwiftUI 컴패니언 앱.
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
cd app && swift build -c release
|
|
59
|
+
# 바이너리: app/.build/release/iMcpApp
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
기능: 서버 상태 표시, 원클릭 권한 설정, Claude 설정 클립보드 복사.
|
|
63
|
+
|
|
52
64
|
## 도구
|
|
53
65
|
|
|
54
66
|
### Notes (12개)
|
|
@@ -255,6 +267,40 @@ MCP 리소스는 Apple 앱의 실시간 데이터를 URI로 제공합니다.
|
|
|
255
267
|
- **idea-to-task** — 아이디어 → 태스크 분해 → Reminders + Calendar 타임 블록
|
|
256
268
|
- **build-log** — 빌드 결과 분석, 에러 로그 또는 Music으로 성공 축하
|
|
257
269
|
|
|
270
|
+
## Developer Agent Pipeline
|
|
271
|
+
|
|
272
|
+
iMcp의 개발자 프롬프트는 Apple 앱들을 자율 에이전트 워크플로우로 연결합니다. 각 프롬프트는 여러 모듈의 도구를 오케스트레이션하여 — AI가 실제 파일시스템, Notes, Calendar, Reminders를 읽어 컨텍스트를 구성하고, 구조화된 결과를 기록합니다.
|
|
273
|
+
|
|
274
|
+
```
|
|
275
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
276
|
+
│ dev-session │
|
|
277
|
+
│ Finder (스캔) → Notes (스펙) → Safari (문서) → Notes (로그) │
|
|
278
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
279
|
+
|
|
280
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
281
|
+
│ debug-loop │
|
|
282
|
+
│ Safari (JS 에러) → Clipboard → Finder (위치 특정) → │
|
|
283
|
+
│ Notes (버그 로그) → Reminders (Fix 태스크) │
|
|
284
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
285
|
+
|
|
286
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
287
|
+
│ idea-to-task │
|
|
288
|
+
│ Notes (아이디어) → AI (분해) → Reminders (태스크) → │
|
|
289
|
+
│ Calendar (타임 블록) │
|
|
290
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
291
|
+
|
|
292
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
293
|
+
│ build-log │
|
|
294
|
+
│ Finder (아웃풋) → Clipboard (로그) → │
|
|
295
|
+
│ ┌ 실패 → Notes (에러 로그) → Reminders (Fix 태스크) │
|
|
296
|
+
│ └ 성공 → Notification → Music (축하) → Notes (성공 로그) │
|
|
297
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
AI 코딩 에이전트(Claude Code, Cursor, Copilot)가 MCP 프롬프트로 호출하도록 설계되어 Mac을 컨텍스트 인식 개발 환경으로 전환합니다.
|
|
301
|
+
|
|
302
|
+
> 데모 영상 준비 중
|
|
303
|
+
|
|
258
304
|
## 설정
|
|
259
305
|
|
|
260
306
|
| 환경 변수 | 기본값 | 설명 |
|
package/README.md
CHANGED
|
@@ -13,7 +13,8 @@ MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contac
|
|
|
13
13
|
- **Recurring events/reminders** — create recurrence rules via EventKit (macOS 26+ Swift bridge)
|
|
14
14
|
- **Photos import/delete** — import and delete photos via PhotoKit (macOS 26+ Swift bridge)
|
|
15
15
|
- **Apple Intelligence** — on-device summarization, rewriting, proofreading (macOS 26+)
|
|
16
|
-
- **
|
|
16
|
+
- **Native menubar app** — SwiftUI companion app for status monitoring, permission setup, config copy
|
|
17
|
+
- **One-click setup** — `setup_permissions` tool or menubar app triggers all macOS permission prompts at once
|
|
17
18
|
- **stdio transport** — secure local communication, no network exposure
|
|
18
19
|
- **Safety annotations** — every tool tagged with readOnly/destructive hints
|
|
19
20
|
|
|
@@ -49,6 +50,17 @@ npm install
|
|
|
49
50
|
npm run build
|
|
50
51
|
```
|
|
51
52
|
|
|
53
|
+
### Menubar App (Optional)
|
|
54
|
+
|
|
55
|
+
A native SwiftUI companion app for server status monitoring and permission setup.
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
cd app && swift build -c release
|
|
59
|
+
# Binary: app/.build/release/iMcpApp
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Features: server status indicator, one-click permission setup, copy Claude config to clipboard.
|
|
63
|
+
|
|
52
64
|
## Tools
|
|
53
65
|
|
|
54
66
|
### Notes (12 tools)
|
|
@@ -255,6 +267,40 @@ MCP Resources expose live data from Apple apps as URIs.
|
|
|
255
267
|
- **idea-to-task** — Break idea into tasks → Reminders + Calendar time blocks
|
|
256
268
|
- **build-log** — Analyze build output, log errors or celebrate success with Music
|
|
257
269
|
|
|
270
|
+
## Developer Agent Pipeline
|
|
271
|
+
|
|
272
|
+
iMcp's developer prompts chain Apple apps into autonomous agent workflows. Each prompt orchestrates multiple tools across modules — the AI reads your actual filesystem, Notes, Calendar, and Reminders to build real context, then writes back structured results.
|
|
273
|
+
|
|
274
|
+
```
|
|
275
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
276
|
+
│ dev-session │
|
|
277
|
+
│ Finder (scan) → Notes (specs) → Safari (docs) → Notes (log) │
|
|
278
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
279
|
+
|
|
280
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
281
|
+
│ debug-loop │
|
|
282
|
+
│ Safari (JS errors) → Clipboard → Finder (locate) → │
|
|
283
|
+
│ Notes (bug log) → Reminders (fix task) │
|
|
284
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
285
|
+
|
|
286
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
287
|
+
│ idea-to-task │
|
|
288
|
+
│ Notes (capture) → AI (decompose) → Reminders (tasks) → │
|
|
289
|
+
│ Calendar (time blocks) │
|
|
290
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
291
|
+
|
|
292
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
293
|
+
│ build-log │
|
|
294
|
+
│ Finder (output) → Clipboard (log) → │
|
|
295
|
+
│ ┌ fail → Notes (error log) → Reminders (fix task) │
|
|
296
|
+
│ └ pass → Notification → Music (celebrate) → Notes (success) │
|
|
297
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
These prompts are designed for AI coding agents (Claude Code, Cursor, Copilot) to invoke as MCP prompts — turning your Mac into a context-aware development environment.
|
|
301
|
+
|
|
302
|
+
> Demo video coming soon.
|
|
303
|
+
|
|
258
304
|
## Configuration
|
|
259
305
|
|
|
260
306
|
| Environment Variable | Default | Description |
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@heznpc/imcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contacts, Mail, Music, Finder, Safari, Photos, Shortcuts, System, and Apple Intelligence. Connect any AI to your Mac.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|
|
@@ -56,6 +56,7 @@
|
|
|
56
56
|
"scripts": {
|
|
57
57
|
"build": "tsc",
|
|
58
58
|
"swift-build": "cd swift && swift build -c release",
|
|
59
|
+
"app-build": "cd app && swift build -c release",
|
|
59
60
|
"clean": "rm -rf dist",
|
|
60
61
|
"dev": "tsx src/index.ts",
|
|
61
62
|
"lint": "eslint src/",
|