apple-photos-mcp 2.1.4 → 2.1.5

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.
Files changed (3) hide show
  1. package/README.md +17 -2
  2. package/build/index.js +16 -10
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -81,9 +81,24 @@ The Codex plugin runs the published `apple-photos-mcp` server through `npx` and
81
81
 
82
82
  ### Other Hosts (Hermes, Antigravity)
83
83
 
84
- Configuration for two more hosts is included — each registers the same `apple-photos` MCP server (`npx -y apple-photos-mcp`). As a Python-sidecar (osxphotos) server it also needs Full Disk Access; see [Requirements](#requirements).
84
+ Two more hosts can run the same `apple-photos` MCP server (`npx -y apple-photos-mcp`). As a Python-sidecar (osxphotos) server it also needs Full Disk Access; see [Requirements](#requirements).
85
85
 
86
- - **[Hermes Agent](https://hermes-agent.nousresearch.com/)** (NousResearch) — Hermes has no plugin/marketplace drop-in. Add the server with `hermes mcp add apple-photos --command npx --args -y apple-photos-mcp`, or merge [`.hermes-plugin/config.yaml`](https://github.com/sweetrb/apple-photos-mcp/blob/main/.hermes-plugin/config.yaml) into `~/.hermes/config.yaml`. Details: [`.hermes-plugin/README.md`](https://github.com/sweetrb/apple-photos-mcp/blob/main/.hermes-plugin/README.md).
86
+ - **[Hermes Agent](https://hermes-agent.nousresearch.com/)** (NousResearch) — Hermes has no plugin/marketplace drop-in, so there is nothing in this repo to install from. Register the server with the CLI:
87
+
88
+ ```bash
89
+ hermes mcp add apple-photos --command npx --args -y apple-photos-mcp
90
+ ```
91
+
92
+ Or add it to `~/.hermes/config.yaml` by hand:
93
+
94
+ ```yaml
95
+ mcp_servers:
96
+ apple-photos:
97
+ command: npx
98
+ args: ["-y", "apple-photos-mcp"]
99
+ ```
100
+
101
+ Restart your Hermes session afterward so the tools load.
87
102
  - **[Antigravity](https://antigravity.google/)** (Google) — add the server entry from [`.antigravity-plugin/mcp_config.json`](https://github.com/sweetrb/apple-photos-mcp/blob/main/.antigravity-plugin/mcp_config.json) to `~/.gemini/config/mcp_config.json` (or via Antigravity's MCP settings).
88
103
 
89
104
  ### Manual Installation
package/build/index.js CHANGED
@@ -23516,17 +23516,20 @@ server.registerTool(
23516
23516
  },
23517
23517
  withErrorHandling(async ({ library, uuid: uuid2, dest, edited, live, raw, overwrite }, extra) => {
23518
23518
  const progressToken = extra?._meta?.progressToken;
23519
+ const inFlight = [];
23519
23520
  const onProgress = progressToken === void 0 ? void 0 : (p) => {
23520
- void extra.sendNotification({
23521
- method: "notifications/progress",
23522
- params: {
23523
- progressToken,
23524
- progress: p.done,
23525
- total: p.total,
23526
- message: p.current ? `Exporting ${p.current} (${p.done + 1}/${p.total})` : `Exported ${p.done}/${p.total}`
23527
- }
23528
- }).catch(() => {
23529
- });
23521
+ inFlight.push(
23522
+ extra.sendNotification({
23523
+ method: "notifications/progress",
23524
+ params: {
23525
+ progressToken,
23526
+ progress: p.done,
23527
+ total: p.total,
23528
+ message: p.current ? `Exporting ${p.current} (${p.done + 1}/${p.total})` : `Exported ${p.done}/${p.total}`
23529
+ }
23530
+ }).catch(() => {
23531
+ })
23532
+ );
23530
23533
  };
23531
23534
  const result = await manager.exportPhotos(uuid2, dest, {
23532
23535
  edited,
@@ -23536,6 +23539,9 @@ server.registerTool(
23536
23539
  library,
23537
23540
  onProgress
23538
23541
  });
23542
+ if (inFlight.length) {
23543
+ await Promise.all(inFlight);
23544
+ }
23539
23545
  const lines = [
23540
23546
  `Destination: ${result.destination}`,
23541
23547
  `Exported: ${result.exportedCount} file(s)`,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "apple-photos-mcp",
3
- "version": "2.1.4",
3
+ "version": "2.1.5",
4
4
  "description": "MCP server for Apple Photos - query, search, export, and inspect the macOS Photos library via Claude and other AI assistants, plus opt-in album/metadata write tools (read-only by default)",
5
5
  "type": "module",
6
6
  "main": "build/index.js",
@@ -87,7 +87,7 @@
87
87
  "test:coverage": "vitest run --coverage",
88
88
  "test:integration": "vitest run --config vitest.integration.config.ts",
89
89
  "test:all": "vitest run && vitest run --config vitest.integration.config.ts",
90
- "version": "node scripts/sync-plugin-version.mjs && git add .claude-plugin .agents/plugins codex .hermes-plugin .antigravity-plugin",
90
+ "version": "node scripts/sync-plugin-version.mjs && git add .claude-plugin .agents/plugins codex .antigravity-plugin",
91
91
  "preinstall": "node -e \"const fs=require('fs');const ua=process.env.npm_config_user_agent||'';if(fs.existsSync('.git')&&!ua.startsWith('pnpm')){console.error('\\nThis repo uses pnpm. npm/yarn resolve dependencies off-lockfile and the committed bundle will mismatch CI.\\n\\n corepack enable && pnpm install --frozen-lockfile\\n');process.exit(1)}\""
92
92
  }
93
93
  }