rewind-mcp-server 0.1.0 → 0.3.0

package/README.md

@@ -1,19 +1,17 @@
 # rewind-mcp-server
 
-MCP (Model Context Protocol) server for the [Rewind](https://rewind.rest) personal data API. Gives Claude natural language access to your listening, running, watching, collecting, and reading data.
+[![CI](https://github.com/pdugan20/rewind/actions/workflows/mcp-server.yml/badge.svg)](https://github.com/pdugan20/rewind/actions/workflows/mcp-server.yml)
+[![npm version](https://img.shields.io/npm/v/rewind-mcp-server?logo=npm)](https://www.npmjs.com/package/rewind-mcp-server)
+[![docs](https://img.shields.io/badge/docs-docs.rewind.rest-blue)](https://docs.rewind.rest/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?logo=opensourceinitiative&logoColor=white)](https://opensource.org/licenses/MIT)
 
-## Features
+MCP server for the [Rewind](https://rewind.rest) personal data API. Gives AI assistants access to your listening, running, watching, collecting, and reading data.
 
-- **26 tools** across 5 domains (listening, running, watching, collecting, reading) + cross-domain search and feed
-- **4 resources** for sync status and year-in-review data
-- **3 prompt templates** for weekly summaries, year-in-review, and period comparisons
-- Works with Claude Desktop, Claude Code, Claude iOS, and claude.ai
+## Setup
 
-## Installation
+### Desktop Apps
 
-### Claude Desktop (Mac)
-
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+Add to your MCP client config (Claude Desktop, ChatGPT, Gemini, etc.):
 
 ```json
 {
@@ -29,112 +27,101 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-Restart Claude Desktop after saving.
+### Mobile & Web
+
+Add as a remote integration in your client's settings:
+
+- **URL**: `https://mcp.rewind.rest/mcp`
+- **Authorization**: `Bearer rw_live_your_key_here`
 
-### Claude Code
+<details>
+<summary>Claude Code</summary>
 
 ```bash
 claude mcp add rewind -- npx -y rewind-mcp-server
 ```
 
-Or add `.mcp.json` to your project root:
+</details>
 
-```json
-{
-  "mcpServers": {
-    "rewind": {
-      "command": "npx",
-      "args": ["-y", "rewind-mcp-server"],
-      "env": {
-        "REWIND_API_KEY": "rw_live_your_key_here"
-      }
-    }
-  }
-}
-```
+Requires a [Rewind API key](https://docs.rewind.rest/authentication). `REWIND_API_URL` defaults to `https://api.rewind.rest`.
 
-### Claude iOS / claude.ai (Web)
+## Tools
 
-These platforms connect to the hosted remote server. Go to Settings > Integrations and add:
+| Domain           | Source           | Tools                                                                                                                                                  |
+| ---------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **Listening**    | Last.fm          | Now playing, recent scrobbles, stats, top artists/albums/tracks, streaks, artist and album details, genre breakdown over time                          |
+| **Running**      | Strava           | Stats, recent runs, personal records, streaks, activity details, per-mile splits, per-year summaries                                                   |
+| **Watching**     | Plex, Letterboxd | Recent watches, movie details, browse by genre/decade/director, stats, genre/decade/director breakdowns                                                |
+| **Collecting**   | Discogs, Trakt   | Vinyl collection, physical media (Blu-ray/4K UHD/HD DVD), collection and media stats                                                                   |
+| **Reading**      | Instapaper       | Recent articles, highlights, random highlight, stats                                                                                                   |
+| **Cross-domain** | All              | Full-text search, unified feed, on-this-day                                                                                                            |
 
-- **URL:** `https://mcp.rewind.rest/mcp`
-- **Authorization:** `Bearer rw_live_your_key_here`
+## Rich responses
 
-## Environment Variables
+Tool responses follow the MCP 2025-06-18 content model and include more than plain text:
 
-| Variable         | Required | Default                   | Description                         |
-| ---------------- | -------- | ------------------------- | ----------------------------------- |
-| `REWIND_API_KEY` | Yes      | --                        | Your Rewind API key (`rw_live_...`) |
-| `REWIND_API_URL` | No       | `https://api.rewind.rest` | API base URL                        |
+- **Images.** Detail tools (`get_movie_details`, `get_album_details`, `get_artist_details`) and list tools (`get_recent_watches`, `get_recent_listens`, `get_top_albums`, `get_vinyl_collection`, etc.) return cover art / posters / artist imagery as `image` content blocks (top-N on lists, default N=5). Pass `include_images: false` to skip them when keeping responses compact matters.
+- **Resource links.** External platform URLs come back as `resource_link` content blocks rather than being baked into prose -- Letterboxd reviews, Strava activities, Discogs releases, Apple Music pages, original article URLs, Last.fm pages.
+- **Structured content.** Every tool also returns `structuredContent` with a JSON shape that mirrors the underlying API response, so the model can reason over exact numbers without re-parsing prose.
 
-## Available Tools
+## Entity resources
 
-### Listening (Last.fm)
+The server exposes `@`-mentionable resources for fetching full detail on any entity:
 
-| Tool                    | Description                  |
-| ----------------------- | ---------------------------- |
-| `get_now_playing`       | Currently playing track      |
-| `get_recent_listens`    | Recent scrobbles             |
-| `get_listening_stats`   | Overall listening statistics |
-| `get_top_artists`       | Top artists by period        |
-| `get_top_albums`        | Top albums by period         |
-| `get_top_tracks`        | Top tracks by period         |
-| `get_listening_streaks` | Current and longest streaks  |
-| `get_artist_details`    | Artist info by ID            |
-| `get_album_details`     | Album info by ID             |
+| Entity         | URI                              | Source endpoint                   |
+| -------------- | -------------------------------- | --------------------------------- |
+| Movie          | `rewind://movie/{id}`            | `/v1/watching/movies/{id}`        |
+| Show           | `rewind://show/{id}`             | `/v1/watching/shows/{id}`         |
+| Album          | `rewind://album/{id}`            | `/v1/listening/albums/{id}`       |
+| Artist         | `rewind://artist/{id}`           | `/v1/listening/artists/{id}`      |
+| Vinyl          | `rewind://vinyl/{id}`            | `/v1/collecting/vinyl/{id}`       |
+| Physical media | `rewind://physical-media/{id}`   | `/v1/collecting/media/{id}`       |
+| Article        | `rewind://article/{id}`          | `/v1/reading/articles/{id}`       |
+| Activity       | `rewind://activity/{id}`         | `/v1/running/activities/{id}`     |
+| Sync status    | `rewind://sync/status`           | `/v1/health/sync`                 |
+| Year in review | `rewind://{domain}/year/{year}`  | `/v1/{domain}/year/{year}`        |
 
-### Running (Strava)
+`search` returns `resource_link`s pointing at these URIs so clients can drill from a match straight into the full record.
 
-| Tool                   | Description                 |
-| ---------------------- | --------------------------- |
-| `get_running_stats`    | Overall running statistics  |
-| `get_recent_runs`      | Recent activities           |
-| `get_personal_records` | PRs at standard distances   |
-| `get_running_streaks`  | Current and longest streaks |
-| `get_activity_details` | Single run details by ID    |
+## Interactive UI (MCP Apps)
 
-### Watching (Plex / Letterboxd)
+`get_recent_watches` advertises a [MCP Apps](https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/) UI resource. On clients that render MCP Apps (Claude Desktop, Claude web, VS Code GitHub Copilot, Goose) the tool returns an interactive poster grid inline in the conversation: thumbhash placeholders, theme-aware cards, clickable Letterboxd reviews, hover states. On clients that do not render MCP Apps the existing text + image + resource_link + structuredContent response is unchanged, so no caller regresses.
 
-| Tool                 | Description                 |
-| -------------------- | --------------------------- |
-| `get_recent_watches` | Recently watched movies/TV  |
-| `get_movie_details`  | Movie info by ID            |
-| `get_watching_stats` | Overall watching statistics |
+## Example Queries
 
-### Collecting (Discogs)
+- "What albums have I been listening to the most recently?"
+- "Compare my mile splits from this month vs last month"
+- "When was the last time I watched a film by Wes Anderson?"
+- "What Beastie Boys records are missing from my vinyl collection?"
+- "How many articles did I read last year and stack-rank the top 10 sources"
+- "Can you give me a quick summary of everything I did last week?"
 
-| Tool                   | Description           |
-| ---------------------- | --------------------- |
-| `get_vinyl_collection` | Browse vinyl records  |
-| `get_collecting_stats` | Collection statistics |
+## Prompts
 
-### Reading (Instapaper)
+The server exposes slash-command prompts that orchestrate multiple tools for common asks:
 
-| Tool                     | Description             |
-| ------------------------ | ----------------------- |
-| `get_recent_reads`       | Recently saved articles |
-| `get_reading_highlights` | Saved highlights        |
-| `get_random_highlight`   | Random highlight        |
-| `get_reading_stats`      | Reading statistics      |
+- `weekly-summary` -- rolls up activity across all domains for the past 7 days
+- `year-in-review` -- comprehensive yearly recap
+- `compare-periods` -- parametric comparison between two time windows in a single domain
+- `letterboxd-review-draft` -- drafts a Letterboxd-style review for your most recent unrated film
+- `training-report` -- coach-style running report for the last 7-14 days
+- `film-diet` -- portrait of your film-watching taste (genre mix, decades, directors)
 
-### Cross-Domain
+## Authentication
 
-| Tool              | Description                         |
-| ----------------- | ----------------------------------- |
-| `search`          | Full-text search across all domains |
-| `get_feed`        | Unified activity feed               |
-| `get_on_this_day` | Historical "on this day" items      |
-| `get_health`      | API and sync health status          |
+**Desktop apps** use the `REWIND_API_KEY` environment variable passed directly to the server process. The server authenticates with the Rewind API using this key as a Bearer token.
 
-## Development
+**Mobile and web clients** connect to the remote server at `mcp.rewind.rest`, which uses OAuth 2.1 with GitHub as the identity provider. The flow:
 
-```bash
-cd mcp-server
-npm install
-npm run build
-REWIND_API_KEY=rw_live_... npm start
-```
+1. Client discovers endpoints via `/.well-known/oauth-authorization-server`
+2. Client dynamically registers via `/register`
+3. User authenticates with GitHub and approves access
+4. Client receives scoped tokens (1h access, 90d refresh, PKCE S256)
+
+The server has **read-only access** to your data. No write or admin operations are exposed.
 
-## License
+## Privacy & Support
 
-MIT
+- [Privacy Policy](https://rewind.rest/privacy)
+- [Documentation](https://docs.rewind.rest/mcp-server)
+- [Report an issue](https://github.com/pdugan20/rewind/issues)

package/dist/__tests__/helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/helpers.test.js

@@ -0,0 +1,131 @@
+import { describe, it, expect, vi } from 'vitest';
+import { text, resourceLink, imageBlock, withRichResponse, withErrorHandling, } from '../tools/helpers.js';
+import { RewindClient } from '../client.js';
+describe('helpers', () => {
+    describe('text()', () => {
+        it('wraps a string in a text content block', () => {
+            expect(text('hello')).toEqual({ type: 'text', text: 'hello' });
+        });
+        it('accepts an empty string', () => {
+            expect(text('')).toEqual({ type: 'text', text: '' });
+        });
+    });
+    describe('resourceLink()', () => {
+        it('builds a resource_link block for a valid URI', () => {
+            const block = resourceLink('https://letterboxd.com/u/film/', 'Letterboxd review');
+            expect(block).toEqual({
+                type: 'resource_link',
+                uri: 'https://letterboxd.com/u/film/',
+                name: 'Letterboxd review',
+            });
+        });
+        it('includes optional mimeType and description', () => {
+            const block = resourceLink('https://example.com', 'Example', {
+                mimeType: 'text/html',
+                description: 'An example site',
+            });
+            expect(block).toMatchObject({
+                type: 'resource_link',
+                uri: 'https://example.com',
+                name: 'Example',
+                mimeType: 'text/html',
+                description: 'An example site',
+            });
+        });
+        it('returns null when uri is null/undefined/empty', () => {
+            expect(resourceLink(null, 'x')).toBeNull();
+            expect(resourceLink(undefined, 'x')).toBeNull();
+            expect(resourceLink('', 'x')).toBeNull();
+        });
+    });
+    describe('imageBlock()', () => {
+        const bytes = new Uint8Array([0xff, 0xd8, 0xff, 0xe0]); // JPEG magic
+        it('base64-encodes bytes fetched from image.cdn_url', async () => {
+            const client = new RewindClient('https://api.test', 'rw_test');
+            const spy = vi.spyOn(client, 'getBinaryFromUrl').mockResolvedValue({
+                bytes,
+                mimeType: 'image/jpeg',
+            });
+            const block = await imageBlock(client, {
+                cdn_url: 'https://cdn.rewind.rest/watching/movies/1/original.jpg',
+            });
+            expect(block).not.toBeNull();
+            expect(block?.type).toBe('image');
+            expect(block?.mimeType).toBe('image/jpeg');
+            expect(block?.data).toBe('/9j/4A==');
+            expect(spy).toHaveBeenCalledWith('https://cdn.rewind.rest/watching/movies/1/original.jpg');
+        });
+        it('falls back to image.url when cdn_url is absent', async () => {
+            const client = new RewindClient('https://api.test', 'rw_test');
+            const spy = vi.spyOn(client, 'getBinaryFromUrl').mockResolvedValue({
+                bytes,
+                mimeType: 'image/jpeg',
+            });
+            await imageBlock(client, { url: 'https://cdn.example/x.jpg' });
+            expect(spy).toHaveBeenCalledWith('https://cdn.example/x.jpg');
+        });
+        it('returns null when image is null or undefined', async () => {
+            const client = new RewindClient('https://api.test', 'rw_test');
+            expect(await imageBlock(client, null)).toBeNull();
+            expect(await imageBlock(client, undefined)).toBeNull();
+        });
+        it('returns null when image has no cdn_url or url', async () => {
+            const client = new RewindClient('https://api.test', 'rw_test');
+            expect(await imageBlock(client, { thumbhash: 'x' })).toBeNull();
+        });
+        it('returns null on fetch failure instead of throwing', async () => {
+            const client = new RewindClient('https://api.test', 'rw_test');
+            vi.spyOn(client, 'getBinaryFromUrl').mockRejectedValue(new Error('network down'));
+            const block = await imageBlock(client, {
+                cdn_url: 'https://cdn.example/x.jpg',
+            });
+            expect(block).toBeNull();
+        });
+    });
+    describe('withRichResponse()', () => {
+        it('returns the handler result on success', async () => {
+            const result = await withRichResponse(async () => ({
+                content: [text('ok')],
+                structuredContent: { value: 42 },
+            }));
+            expect(result).toEqual({
+                content: [{ type: 'text', text: 'ok' }],
+                structuredContent: { value: 42 },
+            });
+        });
+        it('catches exceptions and returns isError=true', async () => {
+            const result = await withRichResponse(async () => {
+                throw new Error('boom');
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0]).toEqual({
+                type: 'text',
+                text: 'Error: boom',
+            });
+        });
+        it('handles non-Error throwables', async () => {
+            const result = await withRichResponse(async () => {
+                throw 'string error';
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toBe('Error: string error');
+        });
+    });
+    describe('withErrorHandling() (legacy text-only wrapper)', () => {
+        it('still works for text-only tool handlers', async () => {
+            const result = await withErrorHandling(async () => 'plain text');
+            expect(result).toEqual({
+                content: [{ type: 'text', text: 'plain text' }],
+            });
+        });
+        it('catches and reports errors', async () => {
+            const result = await withErrorHandling(async () => {
+                throw new Error('nope');
+            });
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toBe('Error: nope');
+        });
+    });
+});
+//# sourceMappingURL=helpers.test.js.map

package/dist/__tests__/helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.js","sourceRoot":"","sources":["../../src/__tests__/helpers.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/image-block.live.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/image-block.live.js

@@ -0,0 +1,41 @@
+/**
+ * Live diagnostic: does imageBlock() actually produce a valid image
+ * content block when run against the real Rewind CDN? No mocks.
+ *
+ * Run: npx tsx src/__tests__/image-block.live.ts
+ */
+import { RewindClient } from '../client.js';
+import { imageBlock } from '../tools/helpers.js';
+const FIXTURE = {
+    movieId: 710,
+    title: "I'm Chevy Chase and You're Not",
+    cdn_url: 'https://cdn.rewind.rest/watching/movies/710/original.jpg?width=300&height=300&fit=cover&format=auto&quality=85&v=1',
+};
+async function main() {
+    // Base URL + api key are irrelevant here -- imageBlock goes through
+    // getBinaryFromUrl which hits the full CDN URL without auth.
+    const client = new RewindClient('https://api.rewind.rest', 'rw_unused');
+    console.log(`Testing imageBlock against live CDN...`);
+    console.log(`Fixture: ${FIXTURE.title} (movie ${FIXTURE.movieId})`);
+    console.log(`URL: ${FIXTURE.cdn_url}\n`);
+    const start = Date.now();
+    const block = await imageBlock(client, { cdn_url: FIXTURE.cdn_url });
+    const ms = Date.now() - start;
+    if (!block) {
+        console.error(`FAIL: imageBlock returned null (fetched in ${ms}ms)`);
+        process.exit(1);
+    }
+    console.log(`SUCCESS (${ms}ms)`);
+    console.log(`- type:      ${block.type}`);
+    console.log(`- mimeType:  ${block.mimeType}`);
+    console.log(`- data size: ${block.data.length} base64 chars`);
+    console.log(`- sniff:     ${block.data.slice(0, 24)}...`);
+    // JPEG base64 starts with /9j/
+    const looksLikeJpeg = block.data.startsWith('/9j/');
+    console.log(`- JPEG?      ${looksLikeJpeg ? 'yes (starts with /9j/)' : 'NO -- unexpected'}`);
+}
+main().catch((err) => {
+    console.error('Unexpected error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=image-block.live.js.map

package/dist/__tests__/image-block.live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-block.live.js","sourceRoot":"","sources":["../../src/__tests__/image-block.live.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,OAAO,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,gCAAgC;IACvC,OAAO,EACL,oHAAoH;CACvH,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,oEAAoE;IACpE,6DAA6D;IAC7D,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;IAExE,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,KAAK,WAAW,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1D,+BAA+B;IAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CACT,gBAAgB,aAAa,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAChF,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/__tests__/server.test.d.ts

@@ -0,0 +1 @@
+export {};