E2E testing

.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'pnpm'
+
+      - name: Install dependencies - root
+        run: pnpm install
+
+      - name: Install dependencies - inspector example
+        run: pnpm install
+        working-directory: examples/inspector
+
+      - name: Install dependencies - cf-agents example
+        run: pnpm install
+        working-directory: examples/servers/cf-agents
+
+      - name: Install dependencies - hono-mcp example
+        run: pnpm install
+        working-directory: examples/servers/hono-mcp
+
+      - name: Install dependencies - test
+        run: pnpm install
+        working-directory: test
+
+      - name: Run tests
+        run: pnpm test
+        working-directory: test

.gitignore

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

AGENT.md

@@ -5,6 +5,12 @@
 - `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: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
+
 ## Code Style Guidelines
 
 ### Imports

examples/inspector/package.json

@@ -17,8 +17,7 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "react-router-dom": "^7.6.2",
-    "tailwindcss": "^4.0.14",
-    "use-mcp": "link:../.."
+    "tailwindcss": "^4.0.14"
   },
   "devDependencies": {
     "@cloudflare/vite-plugin": "^1.5.0",
@@ -34,6 +33,7 @@
     "prettier": "^3.5.3",
     "typescript": "~5.7.2",
     "typescript-eslint": "^8.24.1",
+    "use-mcp": "link:../..",
     "vite": "^6.2.0",
     "wrangler": "^4.19.1"
   },

examples/inspector/vite.config.ts

@@ -5,4 +5,8 @@ import tailwindcss from '@tailwindcss/vite'
 // https://vite.dev/config/
 export default defineConfig({
   plugins: [react(), tailwindcss()],
+  build: {
+    // @ts-ignore
+    minify: !process.env.NO_MINIFY,
+  },
 })

examples/servers/hono-mcp/.gitignore

@@ -0,0 +1,33 @@
+# prod
+dist/
+
+# dev
+.yarn/
+!.yarn/releases
+.vscode/*
+!.vscode/launch.json
+!.vscode/*.code-snippets
+.idea/workspace.xml
+.idea/usage.statistics.xml
+.idea/shelf
+
+# deps
+node_modules/
+.wrangler
+
+# env
+.env
+.env.production
+.dev.vars
+
+# logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# misc
+.DS_Store

examples/servers/hono-mcp/README.md

@@ -0,0 +1,21 @@
+```txt
+npm install
+npm run dev
+```
+
+```txt
+npm run deploy
+```
+
+[For generating/synchronizing types based on your Worker configuration run](https://developers.cloudflare.com/workers/wrangler/commands/#types):
+
+```txt
+npm run cf-typegen
+```
+
+Pass the `CloudflareBindings` as generics when instantiation `Hono`:
+
+```ts
+// src/index.ts
+const app = new Hono<{ Bindings: CloudflareBindings }>()
+```

examples/servers/hono-mcp/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "vengabus",
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy --minify",
+    "cf-typegen": "wrangler types --env-interface CloudflareBindings"
+  },
+  "dependencies": {
+    "hono": "^4.8.2"
+  },
+  "devDependencies": {
+    "@hono/mcp": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.13.1",
+    "wrangler": "^4.21.0",
+    "zod": "^3.25.67"
+  }
+}