good-eggs-mcp-server 0.1.6 → 0.1.8

package/README.md

@@ -27,23 +27,14 @@ MCP server for Good Eggs grocery shopping automation using Playwright. Search fo
 | `add_favorite`                 | Add a product to your favorites                      |
 | `remove_favorite`              | Remove a product from your favorites                 |
 
-## Quick Start
+## Setup
 
 ### Prerequisites
 
 - Node.js 18+
 - A Good Eggs account (create one at [goodeggs.com](https://www.goodeggs.com))
 
-### Installation
-
-```bash
-npm install
-npm run build
-```
-
-### Configuration
-
-Set the following environment variables:
+### Environment Variables
 
 | Variable             | Required | Description                     | Default |
 | -------------------- | -------- | ------------------------------- | ------- |
@@ -52,13 +43,21 @@ Set the following environment variables:
 | `HEADLESS`           | No       | Run browser in headless mode    | `true`  |
 | `TIMEOUT`            | No       | Browser operation timeout (ms)  | `30000` |
 
-### Claude Desktop Configuration
+### Claude Desktop
+
+Make sure you have your Good Eggs account credentials ready.
+
+Then proceed to the setup instructions below. If this is your first time using MCP Servers, you'll want to make sure you have the [Claude Desktop application](https://claude.ai/download) and follow the [official MCP setup instructions](https://modelcontextprotocol.io/quickstart/user).
+
+#### Manual Setup
+
+You're going to need Node working on your machine so you can run `npx` commands in your terminal. If you don't have Node, you can install it from [nodejs.org](https://nodejs.org/en/download).
 
-Add to your `claude_desktop_config.json`:
+macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+Modify your `claude_desktop_config.json` file to add the following:
 
 ```json
 {
@@ -75,7 +74,7 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-Restart Claude Desktop to connect.
+Restart Claude Desktop and you should be ready to go!
 
 ## Usage Examples
 

package/build/index.integration-with-mock.js

@@ -9,8 +9,16 @@
  * Note: The mock client is defined inline because TypeScript's rootDir
  * constraints prevent importing from the tests/ directory.
  */
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createMCPServer } from '../shared/index.js';
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const VERSION = packageJson.version;
 /**
  * Creates a mock Good Eggs client for integration testing.
  * This is kept inline to avoid TypeScript rootDir issues with importing from tests/.
@@ -153,7 +161,7 @@ async function main() {
     const transport = new StdioServerTransport();
     // Create client factory that returns our mock
     const clientFactory = () => createMockGoodEggsClient();
-    const { server, registerHandlers } = createMCPServer();
+    const { server, registerHandlers } = createMCPServer({ version: VERSION });
     await registerHandlers(server, clientFactory);
     await server.connect(transport);
 }

package/build/index.js

@@ -1,7 +1,15 @@
 #!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createMCPServer } from '../shared/index.js';
 import { logServerStart, logError, logWarning } from '../shared/logging.js';
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const VERSION = packageJson.version;
 // =============================================================================
 // ENVIRONMENT VALIDATION
 // =============================================================================
@@ -70,7 +78,9 @@ async function main() {
     // Step 1: Validate environment variables
     validateEnvironment();
     // Step 2: Create server using factory
-    const { server, registerHandlers, cleanup, startBackgroundLogin } = createMCPServer();
+    const { server, registerHandlers, cleanup, startBackgroundLogin } = createMCPServer({
+        version: VERSION,
+    });
     // Step 3: Register all handlers (tools)
     await registerHandlers(server);
     // Step 4: Set up graceful shutdown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "good-eggs-mcp-server",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "MCP server for Good Eggs grocery shopping with Playwright automation",
   "main": "build/index.js",
   "type": "module",

package/shared/index.d.ts

@@ -1,4 +1,4 @@
-export { createMCPServer, GoodEggsClient, type IGoodEggsClient, type ClientFactory, } from './server.js';
+export { createMCPServer, GoodEggsClient, type IGoodEggsClient, type ClientFactory, type CreateMCPServerOptions, } from './server.js';
 export { createRegisterTools } from './tools.js';
 export type { GroceryItem, GroceryDetails, PastOrder, CartResult, CartItem, GoodEggsConfig, } from './types.js';
 export { logServerStart, logError, logWarning, logDebug } from './logging.js';

package/shared/server.d.ts

@@ -100,7 +100,10 @@ export type ClientFactory = () => IGoodEggsClient;
  * @param error The error that caused login to fail
  */
 export type LoginFailedCallback = (error: Error) => void;
-export declare function createMCPServer(): {
+export interface CreateMCPServerOptions {
+    version: string;
+}
+export declare function createMCPServer(options: CreateMCPServerOptions): {
     server: Server<{
         method: string;
         params?: {
@@ -108,6 +111,9 @@ export declare function createMCPServer(): {
             _meta?: {
                 [x: string]: unknown;
                 progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
             } | undefined;
         } | undefined;
     }, {
@@ -116,12 +122,20 @@ export declare function createMCPServer(): {
             [x: string]: unknown;
             _meta?: {
                 [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
             } | undefined;
         } | undefined;
     }, {
         [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
         } | undefined;
     }>;
     registerHandlers: (server: Server, clientFactory?: ClientFactory) => Promise<void>;

package/shared/server.js

@@ -559,24 +559,19 @@ export class GoodEggsClient {
             const nameEl = document.querySelector('h1, [class*="product-name"], [class*="title"]');
             return nameEl?.textContent?.trim() || 'Unknown item';
         });
-        // Look for the favorite/heart button
-        const favoriteButton = await page.$('button[aria-label*="favorite"], button[aria-label*="heart"], button:has([class*="heart"]), [class*="favorite"] button, button[class*="favorite"]');
-        if (!favoriteButton) {
+        // Look for the favorite control - Good Eggs uses a div, not a button
+        const favoriteControl = await page.$('.product-detail__favorite-control');
+        if (!favoriteControl) {
             return {
                 success: false,
                 message: 'Could not find favorite button',
                 itemName,
             };
         }
-        // Check if already favorited (button might have "filled" or "active" state)
-        const isAlreadyFavorited = await page.evaluate((btn) => {
-            const classList = btn.className || '';
-            const ariaPressed = btn.getAttribute('aria-pressed');
-            return (classList.includes('active') ||
-                classList.includes('filled') ||
-                classList.includes('favorited') ||
-                ariaPressed === 'true');
-        }, favoriteButton);
+        // Check if already favorited by looking for 'favorited' class (vs 'not-favorited')
+        const isAlreadyFavorited = await page.evaluate((el) => {
+            return el.classList.contains('favorited');
+        }, favoriteControl);
         if (isAlreadyFavorited) {
             return {
                 success: true,
@@ -584,7 +579,7 @@ export class GoodEggsClient {
                 itemName,
             };
         }
-        await favoriteButton.click();
+        await favoriteControl.click();
         await page.waitForTimeout(500);
         return {
             success: true,
@@ -609,24 +604,19 @@ export class GoodEggsClient {
             const nameEl = document.querySelector('h1, [class*="product-name"], [class*="title"]');
             return nameEl?.textContent?.trim() || 'Unknown item';
         });
-        // Look for the favorite/heart button
-        const favoriteButton = await page.$('button[aria-label*="favorite"], button[aria-label*="heart"], button:has([class*="heart"]), [class*="favorite"] button, button[class*="favorite"]');
-        if (!favoriteButton) {
+        // Look for the favorite control - Good Eggs uses a div, not a button
+        const favoriteControl = await page.$('.product-detail__favorite-control');
+        if (!favoriteControl) {
             return {
                 success: false,
                 message: 'Could not find favorite button',
                 itemName,
             };
         }
-        // Check if already favorited (button might have "filled" or "active" state)
-        const isFavorited = await page.evaluate((btn) => {
-            const classList = btn.className || '';
-            const ariaPressed = btn.getAttribute('aria-pressed');
-            return (classList.includes('active') ||
-                classList.includes('filled') ||
-                classList.includes('favorited') ||
-                ariaPressed === 'true');
-        }, favoriteButton);
+        // Check if favorited by looking for 'favorited' class (vs 'not-favorited')
+        const isFavorited = await page.evaluate((el) => {
+            return el.classList.contains('favorited');
+        }, favoriteControl);
         if (!isFavorited) {
             return {
                 success: true,
@@ -634,7 +624,7 @@ export class GoodEggsClient {
                 itemName,
             };
         }
-        await favoriteButton.click();
+        await favoriteControl.click();
         await page.waitForTimeout(500);
         return {
             success: true,
@@ -788,10 +778,10 @@ export class GoodEggsClient {
         return this.config;
     }
 }
-export function createMCPServer() {
+export function createMCPServer(options) {
     const server = new Server({
         name: 'good-eggs-mcp-server',
-        version: '0.1.0',
+        version: options.version,
     }, {
         capabilities: {
             tools: {},