rewind-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,140 @@
+# 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.
+
+## Features
+
+- **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
+
+## Installation
+
+### Claude Desktop (Mac)
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "rewind": {
+      "command": "npx",
+      "args": ["-y", "rewind-mcp-server"],
+      "env": {
+        "REWIND_API_KEY": "rw_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop after saving.
+
+### Claude Code
+
+```bash
+claude mcp add rewind -- npx -y rewind-mcp-server
+```
+
+Or add `.mcp.json` to your project root:
+
+```json
+{
+  "mcpServers": {
+    "rewind": {
+      "command": "npx",
+      "args": ["-y", "rewind-mcp-server"],
+      "env": {
+        "REWIND_API_KEY": "rw_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Claude iOS / claude.ai (Web)
+
+These platforms connect to the hosted remote server. Go to Settings > Integrations and add:
+
+- **URL:** `https://mcp.rewind.rest/mcp`
+- **Authorization:** `Bearer rw_live_your_key_here`
+
+## Environment Variables
+
+| 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                        |
+
+## Available Tools
+
+### Listening (Last.fm)
+
+| 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             |
+
+### Running (Strava)
+
+| 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    |
+
+### Watching (Plex / Letterboxd)
+
+| Tool                 | Description                 |
+| -------------------- | --------------------------- |
+| `get_recent_watches` | Recently watched movies/TV  |
+| `get_movie_details`  | Movie info by ID            |
+| `get_watching_stats` | Overall watching statistics |
+
+### Collecting (Discogs)
+
+| Tool                   | Description           |
+| ---------------------- | --------------------- |
+| `get_vinyl_collection` | Browse vinyl records  |
+| `get_collecting_stats` | Collection statistics |
+
+### Reading (Instapaper)
+
+| Tool                     | Description             |
+| ------------------------ | ----------------------- |
+| `get_recent_reads`       | Recently saved articles |
+| `get_reading_highlights` | Saved highlights        |
+| `get_random_highlight`   | Random highlight        |
+| `get_reading_stats`      | Reading statistics      |
+
+### Cross-Domain
+
+| 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          |
+
+## Development
+
+```bash
+cd mcp-server
+npm install
+npm run build
+REWIND_API_KEY=rw_live_... npm start
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HTTP client for the Rewind API (api.rewind.rest).
+ * All logging goes to stderr -- stdout is reserved for MCP stdio transport.
+ */
+export declare class RewindClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    get<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+}
+export declare class RewindApiError extends Error {
+    status: number;
+    statusText: string;
+    body: string;
+    constructor(status: number, statusText: string, body: string);
+}
+/**
+ * Create a RewindClient from environment variables.
+ * Throws if required vars are missing.
+ */
+export declare function createClientFromEnv(): RewindClient;

package/dist/client.js

@@ -0,0 +1,62 @@
+/**
+ * HTTP client for the Rewind API (api.rewind.rest).
+ * All logging goes to stderr -- stdout is reserved for MCP stdio transport.
+ */
+const log = (...args) => console.error('[rewind-mcp]', ...args);
+export class RewindClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        // Strip trailing slash
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.apiKey = apiKey;
+    }
+    async get(path, params) {
+        const url = new URL(`/v1${path}`, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        log(`GET ${url.pathname}${url.search}`);
+        const res = await fetch(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new RewindApiError(res.status, res.statusText, body);
+        }
+        return res.json();
+    }
+}
+export class RewindApiError extends Error {
+    status;
+    statusText;
+    body;
+    constructor(status, statusText, body) {
+        super(`Rewind API error: ${status} ${statusText}`);
+        this.status = status;
+        this.statusText = statusText;
+        this.body = body;
+        this.name = 'RewindApiError';
+    }
+}
+/**
+ * Create a RewindClient from environment variables.
+ * Throws if required vars are missing.
+ */
+export function createClientFromEnv() {
+    const apiKey = process.env.REWIND_API_KEY;
+    const apiUrl = process.env.REWIND_API_URL ?? 'https://api.rewind.rest';
+    if (!apiKey) {
+        throw new Error('REWIND_API_KEY environment variable is required. ' +
+            'Set it to your Rewind API key (rw_live_... or rw_admin_...).');
+    }
+    return new RewindClient(apiUrl, apiKey);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAAC;AAE3E,MAAM,OAAO,YAAY;IACf,OAAO,CAAS;IAChB,MAAM,CAAS;IAEvB,YAAY,OAAe,EAAE,MAAc;QACzC,uBAAuB;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,MAAoD;QAEpD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;QAED,GAAG,CAAC,OAAO,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YACtC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAE9B;IACA;IACA;IAHT,YACS,MAAc,EACd,UAAkB,EAClB,IAAY;QAEnB,KAAK,CAAC,qBAAqB,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;QAJ5C,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAQ;QAGnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,yBAAyB,CAAC;IAEvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,mDAAmD;YACjD,8DAA8D,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/consent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Consent page HTML for the OAuth authorization flow.
+ * Shows "Sign in with GitHub" and the requested scopes.
+ */
+export declare function renderConsentPage(options: {
+    clientName: string;
+    scopes: string[];
+    gitHubAuthorizeUrl: string;
+    error?: string;
+}): string;

package/dist/consent.js

@@ -0,0 +1,148 @@
+/**
+ * Consent page HTML for the OAuth authorization flow.
+ * Shows "Sign in with GitHub" and the requested scopes.
+ */
+export function renderConsentPage(options) {
+    const scopeList = options.scopes.length
+        ? options.scopes
+            .map((s) => `<li>${escapeHtml(formatScope(s))}</li>`)
+            .join('')
+        : '<li>Read access to all domains</li>';
+    const errorHtml = options.error
+        ? `<div class="error">${escapeHtml(options.error)}</div>`
+        : '';
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Connect to Rewind</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      background: #0a0a0a;
+      color: #e5e5e5;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      padding: 20px;
+    }
+    .card {
+      background: #1a1a1a;
+      border: 1px solid #2a2a2a;
+      border-radius: 12px;
+      padding: 40px;
+      max-width: 420px;
+      width: 100%;
+    }
+    .logo {
+      font-size: 24px;
+      font-weight: 700;
+      color: #6874e8;
+      margin-bottom: 8px;
+    }
+    .subtitle {
+      color: #888;
+      font-size: 14px;
+      margin-bottom: 24px;
+    }
+    .client-name {
+      font-weight: 600;
+      color: #e5e5e5;
+    }
+    h2 {
+      font-size: 16px;
+      font-weight: 600;
+      margin-bottom: 12px;
+    }
+    ul {
+      list-style: none;
+      margin-bottom: 24px;
+    }
+    li {
+      padding: 8px 0;
+      border-bottom: 1px solid #222;
+      font-size: 14px;
+      color: #ccc;
+    }
+    li:before {
+      content: "\\2713";
+      color: #6874e8;
+      margin-right: 8px;
+    }
+    .github-btn {
+      display: block;
+      width: 100%;
+      padding: 12px;
+      background: #6874e8;
+      color: white;
+      border: none;
+      border-radius: 8px;
+      font-size: 16px;
+      font-weight: 600;
+      cursor: pointer;
+      text-decoration: none;
+      text-align: center;
+      transition: background 0.2s;
+    }
+    .github-btn:hover { background: #5563d6; }
+    .footer {
+      margin-top: 16px;
+      font-size: 12px;
+      color: #666;
+      text-align: center;
+    }
+    .footer a { color: #6874e8; text-decoration: none; }
+    .error {
+      background: #2d1515;
+      border: 1px solid #5c2020;
+      color: #f87171;
+      padding: 12px;
+      border-radius: 8px;
+      font-size: 14px;
+      margin-bottom: 16px;
+    }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <div class="logo">Rewind</div>
+    <p class="subtitle">
+      <span class="client-name">${escapeHtml(options.clientName)}</span> wants to access your Rewind data
+    </p>
+    ${errorHtml}
+    <h2>This will allow access to:</h2>
+    <ul>${scopeList}</ul>
+    <a href="${escapeHtml(options.gitHubAuthorizeUrl)}" class="github-btn">
+      Sign in with GitHub
+    </a>
+    <p class="footer">
+      <a href="https://rewind.rest/privacy">Privacy Policy</a>
+    </p>
+  </div>
+</body>
+</html>`;
+}
+function formatScope(scope) {
+    const labels = {
+        read: 'Read access to all domains',
+        'read:listening': 'Listening history and stats (Last.fm)',
+        'read:running': 'Running activities and stats (Strava)',
+        'read:watching': 'Watch history and stats (Plex, Letterboxd)',
+        'read:collecting': 'Collection data (Discogs)',
+        'read:reading': 'Reading data and highlights (Instapaper)',
+        'read:feed': 'Cross-domain feed and search',
+    };
+    return labels[scope] ?? scope;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=consent.js.map

package/dist/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,iBAAiB,CAAC,OAKjC;IACC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM;QACrC,CAAC,CAAC,OAAO,CAAC,MAAM;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;aACpD,IAAI,CAAC,EAAE,CAAC;QACb,CAAC,CAAC,qCAAqC,CAAC;IAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK;QAC7B,CAAC,CAAC,sBAAsB,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ;QACzD,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAmGyB,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;;MAE1D,SAAS;;UAEL,SAAS;eACJ,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC;;;;;;;;QAQ7C,CAAC;AACT,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,MAAM,GAA2B;QACrC,IAAI,EAAE,4BAA4B;QAClC,gBAAgB,EAAE,uCAAuC;QACzD,cAAc,EAAE,uCAAuC;QACvD,eAAe,EAAE,4CAA4C;QAC7D,iBAAiB,EAAE,2BAA2B;QAC9C,cAAc,EAAE,0CAA0C;QAC1D,WAAW,EAAE,8BAA8B;KAC5C,CAAC;IACF,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist/github-auth.d.ts

@@ -0,0 +1,21 @@
+/**
+ * GitHub OAuth helpers for upstream authentication delegation.
+ * The MCP server uses GitHub as the identity provider -- users authenticate
+ * with GitHub, and we map their GitHub user ID to a Rewind user_id.
+ */
+export interface GitHubUser {
+    id: number;
+    login: string;
+    name: string | null;
+    avatar_url: string;
+}
+/**
+ * Build the GitHub OAuth authorization URL.
+ * Redirects the user to GitHub to authenticate.
+ */
+export declare function getGitHubAuthorizeUrl(clientId: string, redirectUri: string, state: string): string;
+/**
+ * Exchange a GitHub authorization code for an access token,
+ * then fetch the authenticated user's profile.
+ */
+export declare function exchangeGitHubCode(code: string, clientId: string, clientSecret: string): Promise<GitHubUser>;

package/dist/github-auth.js

@@ -0,0 +1,60 @@
+/**
+ * GitHub OAuth helpers for upstream authentication delegation.
+ * The MCP server uses GitHub as the identity provider -- users authenticate
+ * with GitHub, and we map their GitHub user ID to a Rewind user_id.
+ */
+const GITHUB_AUTHORIZE_URL = 'https://github.com/login/oauth/authorize';
+const GITHUB_TOKEN_URL = 'https://github.com/login/oauth/access_token';
+const GITHUB_USER_URL = 'https://api.github.com/user';
+/**
+ * Build the GitHub OAuth authorization URL.
+ * Redirects the user to GitHub to authenticate.
+ */
+export function getGitHubAuthorizeUrl(clientId, redirectUri, state) {
+    const params = new URLSearchParams({
+        client_id: clientId,
+        redirect_uri: redirectUri,
+        scope: 'read:user',
+        state,
+    });
+    return `${GITHUB_AUTHORIZE_URL}?${params.toString()}`;
+}
+/**
+ * Exchange a GitHub authorization code for an access token,
+ * then fetch the authenticated user's profile.
+ */
+export async function exchangeGitHubCode(code, clientId, clientSecret) {
+    // Exchange code for token
+    const tokenRes = await fetch(GITHUB_TOKEN_URL, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: JSON.stringify({
+            client_id: clientId,
+            client_secret: clientSecret,
+            code,
+        }),
+    });
+    if (!tokenRes.ok) {
+        throw new Error(`GitHub token exchange failed: ${tokenRes.status}`);
+    }
+    const tokenData = (await tokenRes.json());
+    if (tokenData.error || !tokenData.access_token) {
+        throw new Error(`GitHub OAuth error: ${tokenData.error_description ?? tokenData.error ?? 'no access token'}`);
+    }
+    // Fetch user profile
+    const userRes = await fetch(GITHUB_USER_URL, {
+        headers: {
+            Authorization: `Bearer ${tokenData.access_token}`,
+            Accept: 'application/vnd.github+json',
+            'User-Agent': 'rewind-mcp-server',
+        },
+    });
+    if (!userRes.ok) {
+        throw new Error(`GitHub user fetch failed: ${userRes.status}`);
+    }
+    return (await userRes.json());
+}
+//# sourceMappingURL=github-auth.js.map

package/dist/github-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-auth.js","sourceRoot":"","sources":["../src/github-auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,oBAAoB,GAAG,0CAA0C,CAAC;AACxE,MAAM,gBAAgB,GAAG,6CAA6C,CAAC;AACvE,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAStD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,WAAmB,EACnB,KAAa;IAEb,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,WAAW;QACzB,KAAK,EAAE,WAAW;QAClB,KAAK;KACN,CAAC,CAAC;IACH,OAAO,GAAG,oBAAoB,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,QAAgB,EAChB,YAAoB;IAEpB,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE;QAC7C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,SAAS,EAAE,QAAQ;YACnB,aAAa,EAAE,YAAY;YAC3B,IAAI;SACL,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIvC,CAAC;IAEF,IAAI,SAAS,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,uBAAuB,SAAS,CAAC,iBAAiB,IAAI,SAAS,CAAC,KAAK,IAAI,iBAAiB,EAAE,CAC7F,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE;QAC3C,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,SAAS,CAAC,YAAY,EAAE;YACjD,MAAM,EAAE,6BAA6B;YACrC,YAAY,EAAE,mBAAmB;SAClC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAe,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Stdio entry point for local usage (Claude Desktop, Claude Code).
+ * Launched as a child process, communicates over stdin/stdout via JSON-RPC.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Stdio entry point for local usage (Claude Desktop, Claude Code).
+ * Launched as a child process, communicates over stdin/stdout via JSON-RPC.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createClientFromEnv } from './client.js';
+import { createServer } from './server.js';
+const log = (...args) => console.error('[rewind-mcp]', ...args);
+async function main() {
+    const client = createClientFromEnv();
+    const server = createServer(client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log('Server started on stdio transport');
+}
+main().catch((error) => {
+    log('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAAC;AAE3E,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+export function registerPrompts(server) {
+    // Weekly summary prompt
+    server.prompt('weekly-summary', 'Generate a summary of activity across all domains for the past week', {}, () => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        'Please summarize my activity from the past week across all domains. Use the following tools to gather the data:',
+                        '',
+                        "1. get_recent_listens (limit 20) -- what I've been listening to",
+                        '2. get_recent_runs (limit 10) -- any runs this week',
+                        "3. get_recent_watches (limit 10) -- movies or TV I've watched",
+                        "4. get_recent_reads (limit 10) -- articles I've been reading",
+                        '5. get_feed (limit 30, from: 7 days ago) -- unified activity',
+                        '',
+                        'Organize the summary by domain. Highlight patterns, notable items, and any streaks or milestones.',
+                        'Keep the tone casual and reflective. Use specific names, numbers, and dates from the data.',
+                    ].join('\n'),
+                },
+            },
+        ],
+    }));
+    // Year in review prompt
+    server.prompt('year-in-review', 'Generate a comprehensive year-in-review for a given year across all domains', {
+        year: z.string().describe('The year to review (e.g. 2025)'),
+    }, ({ year }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `Generate a year-in-review for ${year}. Gather data from all domains:`,
+                        '',
+                        '1. get_listening_stats -- overall listening numbers',
+                        `2. get_top_artists (period: 12month, limit: 10) -- top artists`,
+                        `3. get_top_albums (period: 12month, limit: 10) -- top albums`,
+                        '4. get_running_stats -- running totals',
+                        '5. get_watching_stats -- movie and TV totals',
+                        '6. get_collecting_stats -- collection growth',
+                        '7. get_reading_stats -- reading numbers',
+                        '',
+                        `Create a comprehensive but concise year-in-review for ${year}. Include:`,
+                        '- Key stats and totals per domain',
+                        '- Standout items (most-played artist, longest run, favorite movie, etc.)',
+                        '- Interesting patterns or changes from previous years if apparent',
+                        '- A brief overall reflection',
+                        '',
+                        'Format it as a readable narrative, not just a list of numbers.',
+                    ].join('\n'),
+                },
+            },
+        ],
+    }));
+    // Compare periods prompt
+    server.prompt('compare-periods', 'Compare activity between two time periods for a specific domain', {
+        domain: z
+            .string()
+            .describe('Domain to compare (listening, running, watching, collecting, reading)'),
+        period1: z
+            .string()
+            .describe("First period description (e.g. 'January 2025', 'last month')"),
+        period2: z
+            .string()
+            .describe("Second period description (e.g. 'January 2024', 'this month')"),
+    }, ({ domain, period1, period2 }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `Compare my ${domain} activity between ${period1} and ${period2}.`,
+                        '',
+                        `Use the appropriate tools for the ${domain} domain to gather data for both periods.`,
+                        'For each period, get stats, recent activity, and any relevant top lists.',
+                        '',
+                        'Present the comparison as:',
+                        '- Side-by-side key metrics',
+                        '- Notable differences and trends',
+                        '- Standout items unique to each period',
+                        '',
+                        'Keep the analysis specific and data-driven.',
+                    ].join('\n'),
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,wBAAwB;IACxB,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,qEAAqE,EACrE,EAAE,EACF,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,iHAAiH;wBACjH,EAAE;wBACF,iEAAiE;wBACjE,qDAAqD;wBACrD,+DAA+D;wBAC/D,8DAA8D;wBAC9D,8DAA8D;wBAC9D,EAAE;wBACF,mGAAmG;wBACnG,4FAA4F;qBAC7F,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,wBAAwB;IACxB,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,6EAA6E,EAC7E;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;KAC5D,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACb,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,iCAAiC,IAAI,iCAAiC;wBACtE,EAAE;wBACF,qDAAqD;wBACrD,gEAAgE;wBAChE,8DAA8D;wBAC9D,wCAAwC;wBACxC,8CAA8C;wBAC9C,8CAA8C;wBAC9C,yCAAyC;wBACzC,EAAE;wBACF,yDAAyD,IAAI,YAAY;wBACzE,mCAAmC;wBACnC,0EAA0E;wBAC1E,mEAAmE;wBACnE,8BAA8B;wBAC9B,EAAE;wBACF,gEAAgE;qBACjE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,yBAAyB;IACzB,MAAM,CAAC,MAAM,CACX,iBAAiB,EACjB,iEAAiE,EACjE;QACE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,CACP,uEAAuE,CACxE;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,8DAA8D,CAC/D;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,+DAA+D,CAChE;KACJ,EACD,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACjC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,cAAc,MAAM,qBAAqB,OAAO,QAAQ,OAAO,GAAG;wBAClE,EAAE;wBACF,qCAAqC,MAAM,0CAA0C;wBACrF,0EAA0E;wBAC1E,EAAE;wBACF,4BAA4B;wBAC5B,4BAA4B;wBAC5B,kCAAkC;wBAClC,wCAAwC;wBACxC,EAAE;wBACF,6CAA6C;qBAC9C,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RewindClient } from './client.js';
+export declare function registerResources(server: McpServer, client: RewindClient): void;