✅ Deploy Preview for tweakphp ready!

Name	Link
🔨 Latest commit	63e2234
🔍 Latest deploy log	https://app.netlify.com/projects/tweakphp/deploys/6925770d8875e50008d41a40
😎 Deploy Preview	https://deploy-preview-7--tweakphp.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Docs need updating — Claude Desktop config is incorrect

The current Claude Desktop configuration example requires Node.js to be installed on the user's machine:

{
  "mcpServers": {
    "tweakphp": {
      "command": "node",
      "args": ["-e", "require('http').request(...)"],
      "env": {}
    }
  }
}

This is exactly the problem reported by users in tweakphp/tweakphp#202 — the MCP server runs inside Electron's bundled Node.js, so no system Node.js is required. The transport is Streamable HTTP, not stdio.

Correct configuration

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tweakphp": {
      "url": "http://127.0.0.1:3000/mcp",
      "type": "http"
    }
  }
}

Cursor (.cursor/mcp.json or global config):

{
  "mcpServers": {
    "tweakphp": {
      "url": "http://127.0.0.1:3000/mcp",
      "type": "http"
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "tweakphp": {
      "url": "http://127.0.0.1:3000/mcp",
      "type": "http"
    }
  }
}

Custom MCP Client section

The TypeScript example uses StdioClientTransport which is wrong. The server speaks Streamable HTTP:

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'

const client = new Client({ name: 'my-agent', version: '1.0.0' })

await client.connect(new StreamableHTTPClientTransport(
  new URL('http://127.0.0.1:3000/mcp')
))

Summary of required changes in docs/mcp-server.md

1. Replace the "command": "node" Claude Desktop config with "url" + "type": "http"
2. Fix the Cursor config (it's already correct — just verify the path note)
3. Replace StdioClientTransport with StreamableHTTPClientTransport in the custom client example
4. Add a note that no Node.js installation is required — the server runs inside the TweakPHP app

✅ Deploy Preview for tweakphp ready!

Name	Link
🔨 Latest commit	fb59f1b
🔍 Latest deploy log	https://app.netlify.com/projects/tweakphp/deploys/69c7ff02228462000878d61c
😎 Deploy Preview	https://deploy-preview-7--tweakphp.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Updated: correct client configuration examples

Based on the investigation in tweakphp/tweakphp#202, the Claude Desktop configuration example in this PR was incorrect — it used "command": "node" which requires Node.js on the user's machine. This is exactly the root cause of the reported failures.

The MCP server runs inside Electron's bundled Node.js — no system Node.js is needed. The transport is Streamable HTTP.

Changes made to docs/mcp-server.md

Claude Desktop — replaced stdio/node approach with HTTP URL config:

{
  "mcpServers": {
    "tweakphp": {
      "url": "http://127.0.0.1:3000/mcp",
      "type": "http"
    }
  }
}

Cursor — same HTTP URL pattern (.cursor/mcp.json or global ~/.cursor/mcp.json):

{
  "mcpServers": {
    "tweakphp": {
      "url": "http://127.0.0.1:3000/mcp",
      "type": "http"
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "tweakphp": {
      "url": "http://127.0.0.1:3000/mcp",
      "type": "http"
    }
  }
}

Custom MCP Client — replaced StdioClientTransport with StreamableHTTPClientTransport:

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'

const client = new Client({ name: 'my-agent', version: '1.0.0' })
await client.connect(new StreamableHTTPClientTransport(
  new URL('http://127.0.0.1:3000/mcp')
))

Also added a note that no Node.js installation is required on the host machine.

Also resolved the package-lock.json conflict after rebasing on upstream/main.