feat(mcp): hono/mcp v0.2 (#1318)

* chore: renamed files

* chore: corrected the imports

* feat: updated the streamable transport class

* chore: corrected the test

* chore: formated the code

* chore: basic stuff

* chore: minor changes

* chore: more changes

* chore: more changes

* chore: minor changes

* chore: completed test conversion

* chore: formatted file

* chore: corrected all the tests

* chore: renamed the streamableHttp files

* chore: added a new index file

* wip

* chore: minor changes

* chore: minor changes

* chore: resolved the type errors

* chore: minor changes

* feat: added sse transport

* chore: updated the imports

* chore: minor change

* ci: apply automated fixes

* add `pkce-challenge` to `devDependencies`

* update deno.json to resolve the type issue

* chore: renamed the files

* chore: updated readme

* ci: apply automated fixes

* chore: added changeset

* chore: updated lockfile

* ci: apply automated fixes

* chore: corrected the merge

* chore: updated the tests for streamable htttp

* chore: removed SSE

* chore: removed console.log

* chore: minor changes

* chore: unref keepAlive timer to prevent server shutdown blocking

* feat: added simple mcp auth router

* chore: updated package.json

* chore: minor changes

* chore: minor changes

* chore: minor changes

* chore: resolved test issues

* chore: minor change

* chore: added deno ignore

* chore: updated the build step

* chore: minor change

* chore: minor changes

* chore: minor changes

* chore: minor changes

* chore: resolve the attw issue

* chore: minor changes

* chore: minor changes

* chore: formatted code

* chore: checking something

* chore: updated the import to be not node specific

* chore: minor changes

* ci: apply automated fixes

* feat: added memory store

* chore: minor change

* fix: using the new bearer auth middleware

* fix: corrected lockfile

* fix: corrected the tsdown config

* fix: corrected hono version in deno.json

* fix: added dynamic import for hono-rate-limiter

* chore: shifted pkce-challenge to dep.

---------

Co-authored-by: Yusuke Wada <yusuke@kamawada.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Author: 3 people

.changeset/wild-doodles-repeat.md

@@ -0,0 +1,5 @@
+---
+'@hono/mcp': minor
+---
+
+Minor improvements and added support for Auth

packages/mcp/README.md

@@ -1,8 +1,8 @@
 # Hono MCP (Model Context Protocol)
 
-Connect Hono with a Model Context Protocol (MCP) server over HTTP Streaming Transport.
+Connect Hono to a Model Context Protocol (MCP) server over HTTP Streaming Transport.
 
-## Usage
+## Streamable HTTP Transport
 
 ```ts
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
@@ -17,15 +17,45 @@ const mcpServer = new McpServer({
   version: '1.0.0',
 })
 
+// Initialize the transport
+const transport = new StreamableHTTPTransport()
+
 app.all('/mcp', async (c) => {
-  const transport = new StreamableHTTPTransport()
-  await mcpServer.connect(transport)
+  if (!mcp.isConnected()) {
+    // Connect the mcp with the transport
+    await mcp.connect(transport)
+  }
+
   return transport.handleRequest(c)
 })
 
 export default app
 ```
 
+## Auth
+
+The simplest way to setup MCP Auth when using 3rd party auth providers.
+
+```ts
+import { Hono } from 'hono'
+import { simpleMcpAuthRouter } from '@hono/mcp'
+
+const app = new Hono()
+
+app.route(
+  '/',
+  simpleMcpAuthRouter({
+    issuer: '[auth provider domain]',
+    resourceServerUrl: new URL('http://localhost:3000/mcp'),
+  })
+)
+
+// ...
+// Logic to connect with the transport
+```
+
+For implementing custom auth, check out the docs - <https://honohub.dev/docs/hono-mcp>
+
 ## Author
 
 Aditya Mathur <https://github.com/mathuraditya724>

packages/mcp/deno.json

@@ -1,12 +1,14 @@
 {
   "name": "@hono/mcp",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "license": "MIT",
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./src/index.ts",
+    "./auth": "./src/auth/index.ts"
   },
   "imports": {
-    "hono": "jsr:@hono/hono@^4.8.3"
+    "hono": "jsr:@hono/hono@^4.10.6",
+    "hono-rate-limiter": "jsr:@hono-rate-limiter/hono-rate-limiter@^0.4.2"
   },
   "publish": {
     "include": ["deno.json", "README.md", "src/**/*.ts"],

packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hono/mcp",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "MCP Middleware for Hono",
   "type": "module",
   "module": "dist/index.js",
@@ -16,13 +16,25 @@
     "test": "vitest"
   },
   "exports": {
-    "import": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
-    "require": {
-      "types": "./dist/index.d.cts",
-      "default": "./dist/index.cjs"
+    "./auth": {
+      "import": {
+        "types": "./dist/auth/index.d.ts",
+        "default": "./dist/auth/index.js"
+      },
+      "require": {
+        "types": "./dist/auth/index.d.cts",
+        "default": "./dist/auth/index.cjs"
+      }
     }
   },
   "license": "MIT",
@@ -35,14 +47,21 @@
     "url": "git+https://github.com/honojs/middleware.git",
     "directory": "packages/mcp"
   },
-  "homepage": "https://github.com/honojs/middleware",
+  "homepage": "https://honohub.dev/docs/hono-mcp",
+  "dependencies": {
+    "pkce-challenge": "^5.0.0"
+  },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "hono": ">=4.0.0"
+    "@modelcontextprotocol/sdk": "^1.17.3",
+    "hono": "*",
+    "hono-rate-limiter": "^0.4.2"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.4",
     "@modelcontextprotocol/sdk": "^1.19.1",
-    "hono": "^4.10.1",
+    "@types/node": "^24.2.1",
+    "hono": "^4.10.6",
+    "hono-rate-limiter": "^0.4.2",
     "tsdown": "^0.15.9",
     "typescript": "^5.8.2",
     "vitest": "^3.2.4",