Fix auto-update: ensure users always get latest MCP server version

Changed all configuration commands to use @mcp-pointer/server@latest instead of cached version, ensuring automatic updates.

Author: elieteyssedou

.changeset/fix-auto-update.md

@@ -0,0 +1,11 @@
+---
+"@mcp-pointer/server": patch
+---
+
+Fix auto-update configuration to always use latest version
+
+Users were stuck on the first installed version because npx cached the initial version. Updated all MCP server configurations to use `@mcp-pointer/server@latest` ensuring users always get the newest version when their AI tool starts the server.
+
+- Updated Claude Code, Cursor, and Windsurf configurations
+- Added instructions for existing users to reconfigure
+- Updated documentation and troubleshooting sections

README.md

@@ -88,13 +88,18 @@ npx -y @mcp-pointer/server config manual # Shows manual configuration for ot
 
 After configuration, **restart your coding tool** to load the MCP connection.
 
+> **🔄 Already using MCP Pointer?** Run the config command again to update to auto-updating configuration:
+> ```bash
+> npx -y @mcp-pointer/server config <your-tool> # Reconfigures to always use latest version
+> ```
+
 ### 3. Start Using
 
 1. **Navigate to any webpage** 
 2. **`Option+Click`** any element to select it
 3. **Ask your AI** to analyze the targeted element!
 
-Your AI tool will automatically start the MCP server when needed using the `npx -y @mcp-pointer/server start` command.
+Your AI tool will automatically start the MCP server when needed using the `npx -y @mcp-pointer/server@latest start` command.
 
 **Available MCP Tool:**
 - `get-pointed-element` - Get textual information about the currently pointed DOM element from the browser extension
@@ -131,15 +136,15 @@ Your AI tool will automatically start the MCP server when needed using the `npx
 
 ### Extension Not Connecting
 
-1. Make sure MCP server is running: `npx -y @mcp-pointer/server start`
+1. Make sure MCP server is running: `npx -y @mcp-pointer/server@latest start`
 2. Check browser console for WebSocket errors
 3. Verify port 7007 is not blocked by firewall
 
 ### MCP Tools Not Available
 
 1. Restart your AI assistant after installing
 2. Check MCP configuration: `mcp-pointer config <your-tool>` 
-3. Verify server is running: `npx -y @mcp-pointer/server start`
+3. Verify server is running: `npx -y @mcp-pointer/server@latest start`
 
 ### Elements Not Highlighting
 

packages/server/README.md

@@ -87,7 +87,7 @@ describe('configCommand', () => {
  const addCommand = mockExecSync.mock.calls[1][0];
 
  // Verify exact command structure for add command
- const expectedCommand = 'claude mcp add pointer -s user --env MCP_POINTER_PORT=7007 -- npx -y @mcp-pointer/server start';
+ const expectedCommand = 'claude mcp add pointer -s user --env MCP_POINTER_PORT=7007 -- npx -y @mcp-pointer/server@latest start';
  expect(addCommand).toBe(expectedCommand);
 
  // Verify success message
@@ -101,7 +101,7 @@ describe('configCommand', () => {
 
  expect(mockExecSync).toHaveBeenCalledTimes(2);
  const addCommand = mockExecSync.mock.calls[1][0];
- const expectedCommand = 'claude mcp add pointer -s user --env MCP_POINTER_PORT=8888 -- npx -y @mcp-pointer/server start';
+ const expectedCommand = 'claude mcp add pointer -s user --env MCP_POINTER_PORT=8888 -- npx -y @mcp-pointer/server@latest start';
  expect(addCommand).toBe(expectedCommand);
  });
 
@@ -117,7 +117,7 @@ describe('configCommand', () => {
 
  // Second call should be add command
  const addCommand = mockExecSync.mock.calls[1][0];
- expect(addCommand).toBe('claude mcp add pointer -s user --env MCP_POINTER_PORT=7007 -- npx -y @mcp-pointer/server start');
+ expect(addCommand).toBe('claude mcp add pointer -s user --env MCP_POINTER_PORT=7007 -- npx -y @mcp-pointer/server@latest start');
 
  expect(mockLoggerInfo).toHaveBeenCalledWith(expect.stringContaining('🔄 Removed existing MCP Pointer configuration'));
  expect(mockLoggerInfo).toHaveBeenCalledWith(expect.stringContaining('✅ Successfully configured MCP Pointer for Claude Code'));
@@ -177,7 +177,7 @@ describe('configCommand', () => {
  const configObj = JSON.parse(decodedConfig);
 
  expect(configObj.command).toBe('npx');
- expect(configObj.args).toEqual(['-y', '@mcp-pointer/server', 'start']);
+ expect(configObj.args).toEqual(['-y', '@mcp-pointer/server@latest', 'start']);
  expect(configObj.env.MCP_POINTER_PORT).toBe('7007');
 
  expect(mockLoggerInfo).toHaveBeenCalledWith(expect.stringContaining('✅ MCP Pointer configuration sent to Cursor IDE'));
@@ -216,7 +216,7 @@ describe('configCommand', () => {
 
  const pointerConfig = writtenConfig.mcpServers.pointer;
  expect(pointerConfig.command).toBe('npx');
- expect(pointerConfig.args).toEqual(['-y', '@mcp-pointer/server', 'start']);
+ expect(pointerConfig.args).toEqual(['-y', '@mcp-pointer/server@latest', 'start']);
  expect(pointerConfig.env.MCP_POINTER_PORT).toBe('7007');
 
  expect(mockLoggerInfo).toHaveBeenCalledWith(expect.stringContaining('✅ Successfully configured MCP Pointer for Windsurf IDE'));
@@ -237,7 +237,7 @@ describe('configCommand', () => {
  expect(loggedMessages).toContain('"pointer"');
  expect(loggedMessages).toContain('"command": "npx"');
  expect(loggedMessages).toContain('"-y"');
- expect(loggedMessages).toContain('"@mcp-pointer/server"');
+ expect(loggedMessages).toContain('"@mcp-pointer/server@latest"');
  expect(loggedMessages).toContain('"start"');
  });
  });

packages/server/src/__tests__/config.test.ts

@@ -47,7 +47,7 @@ function configureClaudeCode(port: string) {
  }
 
  // Now add the server configuration
- const command = `claude mcp add ${MCP_SERVER_NAME} -s user --env MCP_POINTER_PORT=${port} -- npx -y @mcp-pointer/server start`;
+ const command = `claude mcp add ${MCP_SERVER_NAME} -s user --env MCP_POINTER_PORT=${port} -- npx -y @mcp-pointer/server@latest start`;
  execSync(command, { stdio: 'pipe' });
 
  logger.info('✅ Successfully configured MCP Pointer for Claude Code (user-wide)');
@@ -66,7 +66,7 @@ function configureCursor(port: string) {
  // Create the MCP server configuration
  const cursorConfig = {
  command: 'npx',
- args: ['-y', '@mcp-pointer/server', 'start'],
+ args: ['-y', '@mcp-pointer/server@latest', 'start'],
  env: {
  MCP_POINTER_PORT: port,
  },
@@ -124,7 +124,7 @@ function configureWindsurf(port: string) {
  // Prepare the MCP Pointer configuration
  const mcpPointerConfig = {
  command: 'npx',
- args: ['-y', '@mcp-pointer/server', 'start'],
+ args: ['-y', '@mcp-pointer/server@latest', 'start'],
  env: {
  MCP_POINTER_PORT: port,
  },
@@ -174,7 +174,7 @@ function showManualConfig(port: string) {
  mcpServers: {
  [MCP_SERVER_NAME]: {
  command: 'npx',
- args: ['-y', '@mcp-pointer/server', 'start'],
+ args: ['-y', '@mcp-pointer/server@latest', 'start'],
  env: {
  MCP_POINTER_PORT: port,
  },