[WIP] Draft PR for the idea of integration tests

.gitignore

@@ -1,3 +1,4 @@
 node_modules/
 dist/
 *.tsbuildinfo
+.env

examples/ping-server/src/index.ts

@@ -21,7 +21,22 @@ server.withTransport(transport);
 app.post('/mcp', async (c) => {
   try {
     const request = c.req.raw;
-    return transport.handleRequest(request);
+    // Log incoming request details
+    console.log('--- Incoming /mcp request ---');
+    console.log('Method:', request.method);
+    console.log('URL:', request.url);
+    console.log('Headers:', JSON.stringify(Object.fromEntries(request.headers.entries()), null, 2));
+    const reqBody = await request.clone().text();
+    console.log('Body:', reqBody);
+
+    // Hand off to transport
+    const response = await transport.handleRequest(request);
+    // Log outgoing response details
+    console.log('--- Outgoing /mcp response ---');
+    console.log('Status:', response.status);
+    const resBody = await response.clone().text();
+    console.log('Body:', resBody);
+    return response;
   } catch (error) {
     console.error('Error handling MCP request:', error);
     return new Response(JSON.stringify({ error: 'Internal server error' }), {

examples/taffrail/README.md

@@ -0,0 +1,37 @@
+# Simple ping server
+
+The following is a very simple "ping" MCP server.
+
+It has no tools, it has no
+capabilities: it primarily only responds to `method.ping` requests after the initialization flow
+[as defined in the MCP spec](https://modelcontextprotocol.io/specification/2025-03-26/basic/utilities/ping).
+
+## 🏃 Build & run the server
+
+```
+npm i
+npm run build
+npm run start
+```
+
+## 🧠 Interact
+
+Use the [Model Context Protocol Inspector](https://github.com/modelcontextprotocol/inspector)
+and `localhost:3000/mcp`.
+
+```sh
+npx @modelcontextprotocol/inspector
+```
+
+or curl:
+
+```sh
+curl -X POST \
+  -H 'Accept: application/json' \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "123",
+    "method": "ping"
+  }' \
+  localhost:3000/mcp
+```