Dev tooling tweaks

Author: geelen

.gitignore

@@ -5,3 +5,4 @@ dist
 .aider*
 
 **/.claude/settings.local.json
+/public

AGENT.md

@@ -1,12 +1,17 @@
 # use-mcp Project Guidelines
 
 ## Build, Lint, and Test Commands
-- `pnpm dev`: Run development build with watch mode
+- `pnpm dev`: Run development build with watch mode and start all examples/servers
+  - Chat UI: http://localhost:5002
+  - Inspector: http://localhost:5001
+  - Hono MCP Server: http://localhost:5101
+  - CF Agents MCP Server: http://localhost:5102
 - `pnpm build`: Build the project
 - `pnpm check`: Run prettier checks and TypeScript type checking
 
 ### Integration Tests (in /test directory)
-- `cd test && pnpm test`: Run integration tests with visible browser
+- `cd test && pnpm test`: Run integration tests headlessly (default)
+- `cd test && pnpm test:headed`: Run integration tests with visible browser
 - `cd test && pnpm test:headless`: Run integration tests headlessly 
 - `cd test && pnpm test:watch`: Run integration tests in watch mode
 - `cd test && pnpm test:ui`: Run integration tests with interactive UI

README.md

@@ -8,7 +8,7 @@
 
 A lightweight React hook for connecting to [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol) servers. Simplifies authentication and tool calling for AI systems implementing the MCP standard.
 
-Try it out: [MCP Inspector](https://inspector.use-mcp.dev) | [Cloudflare Workers AI Playground](https://playground.ai.cloudflare.com/)
+Try it out: [Chat Demo](https://chat.use-mcp.dev) | [MCP Inspector](https://inspector.use-mcp.dev) | [Cloudflare Workers AI Playground](https://playground.ai.cloudflare.com/)
 
 ## Installation
 
@@ -20,6 +20,31 @@ pnpm add use-mcp
 yarn add use-mcp
 ```
 
+## Development
+
+To run the development environment with all examples and servers:
+
+```bash
+pnpm dev
+```
+
+This starts:
+- **Inspector**: http://localhost:5001 - MCP server debugging tool
+- **Chat UI**: http://localhost:5002 - Example chat interface
+- **Hono MCP Server**: http://localhost:5101 - Example MCP server
+- **CF Agents MCP Server**: http://localhost:5102 - Cloudflare Workers AI MCP server
+
+### Testing
+
+Integration tests are located in the `test/` directory and run headlessly by default:
+
+```bash
+cd test && pnpm test              # Run tests headlessly (default)
+cd test && pnpm test:headed       # Run tests with visible browser
+cd test && pnpm test:watch        # Run tests in watch mode
+cd test && pnpm test:ui           # Run tests with interactive UI
+```
+
 ## Features
 
 - 🔄 Automatic connection management with reconnection and retries

examples/servers/cf-agents/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "scripts": {
     "deploy": "wrangler deploy",
-    "dev": "wrangler dev",
+    "dev": "wrangler dev --port 5102",
     "format": "biome format --write",
     "lint:fix": "biome lint --fix",
     "start": "wrangler dev",
@@ -22,6 +22,6 @@
     "agents": "^0.0.100",
     "hono": "^4.8.3",
     "typescript": "^5.8.3",
-    "wrangler": "^4.22.0"
+    "wrangler": "^4.23.0"
   }
 }

examples/servers/cf-agents/pnpm-lock.yaml

@@ -1,7 +1,7 @@
 {
   "name": "vengabus",
   "scripts": {
-    "dev": "wrangler dev",
+    "dev": "wrangler dev --port 5101",
     "deploy": "wrangler deploy --minify",
     "cf-typegen": "wrangler types --env-interface CloudflareBindings"
   },
@@ -11,7 +11,7 @@
   "devDependencies": {
     "@hono/mcp": "^0.1.0",
     "@modelcontextprotocol/sdk": "^1.13.3",
-    "wrangler": "^4.21.0",
+    "wrangler": "^4.23.0",
     "zod": "^3.25.67"
   }
 }

examples/servers/hono-mcp/package.json

@@ -21,7 +21,10 @@
     }
   },
   "scripts": {
-    "dev": "tsup --watch",
+    "install:all": "concurrently 'pnpm install' 'cd examples/chat-ui && pnpm install' 'cd examples/inspector && pnpm install' 'cd examples/servers/hono-mcp && pnpm install' 'cd examples/servers/cf-agents && pnpm install'",
+    "dev": "concurrently 'pnpm:build:watch' 'cd examples/chat-ui && pnpm dev' 'cd examples/inspector && pnpm dev' 'sleep 1 && cd examples/servers/hono-mcp && pnpm dev' 'sleep 2 && cd examples/servers/cf-agents && pnpm dev'",
+    "deploy:all": "concurrently 'pnpm build:site && pnpm deploy:site' 'cd examples/chat-ui && pnpm run deploy' 'cd examples/inspector && pnpm run deploy'",
+    "build:watch": "tsup --watch",
     "build": "tsup",
     "check": "prettier --check . && tsc",
     "prettier:fix": "prettier --write .",
@@ -37,6 +40,7 @@
   "devDependencies": {
     "@axodotdev/oranda": "^0.6.5",
     "@types/react": "^19.0.12",
+    "concurrently": "^9.2.0",
     "husky": "^9.1.7",
     "prettier": "^3.5.3",
     "react": "^19.0.0",