readme for new packages

Author: mattzcarey

examples/shared/tsconfig.json

@@ -6,6 +6,7 @@
         "paths": {
             "*": ["./*"],
             "@modelcontextprotocol/server": ["./node_modules/@modelcontextprotocol/server/src/index.ts"],
+            "@modelcontextprotocol/express": ["./node_modules/@modelcontextprotocol/express/src/index.ts"],
             "@modelcontextprotocol/core": [
                 "./node_modules/@modelcontextprotocol/server/node_modules/@modelcontextprotocol/core/src/index.ts"
             ],

packages/middleware/express/README.md

@@ -0,0 +1,35 @@
+# @modelcontextprotocol/express
+
+Express middleware and OAuth server support for MCP.
+
+## Installation
+
+```bash
+npm install @modelcontextprotocol/express
+```
+
+## Exports
+
+- `createMcpExpressApp()` - Create an Express app with MCP-compatible middleware
+- `mcpAuthRouter()` - OAuth 2.0 authorization server router
+- `requireBearerAuth()` - Bearer token authentication middleware
+- `mcpAuthMetadataRouter()` - Protected resource metadata endpoints
+
+## Usage
+
+```typescript
+import { createMcpExpressApp, mcpAuthRouter } from '@modelcontextprotocol/express';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/node';
+import { McpServer } from '@modelcontextprotocol/server';
+
+const app = createMcpExpressApp();
+const server = new McpServer({ name: 'my-server', version: '1.0.0' });
+
+app.post('/mcp', async (req, res) => {
+  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: () => crypto.randomUUID() });
+  await server.connect(transport);
+  await transport.handleRequest(req, res, req.body);
+});
+
+app.listen(3000);
+```

packages/middleware/node/README.md

@@ -0,0 +1,33 @@
+# @modelcontextprotocol/node
+
+Node.js HTTP adapters for MCP servers. Wraps the Web Standards `HTTPServerTransport` for compatibility with Node.js HTTP types (`IncomingMessage`/`ServerResponse`).
+
+## Installation
+
+```bash
+npm install @modelcontextprotocol/node
+```
+
+## Exports
+
+- `StreamableHTTPServerTransport` - HTTP transport for Node.js servers
+- `SSEServerTransport` - Legacy SSE transport (protocol version 2024-11-05)
+
+## Usage
+
+```typescript
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/node';
+import { McpServer } from '@modelcontextprotocol/server';
+import http from 'node:http';
+
+const server = new McpServer({ name: 'my-server', version: '1.0.0' });
+const transport = new StreamableHTTPServerTransport({
+  sessionIdGenerator: () => crypto.randomUUID()
+});
+
+await server.connect(transport);
+
+http.createServer((req, res) => {
+  transport.handleRequest(req, res);
+}).listen(3000);
+```