add cli support (#12)

* update: update the docs to match the new spec

* add cli support

* update the basePath fix

* update the CLI

* updated changeset

* update readme

* updated changeset

* update readme (again)

Author: R44VC0RP

.changeset/dirty-seas-greet.md

@@ -0,0 +1,5 @@
+---
+"@vercel/mcp-adapter": patch
+---
+
+updated readme

.changeset/petite-badgers-tie.md

@@ -0,0 +1,5 @@
+---
+"@vercel/mcp-adapter": minor
+---
+
+added cli support to auto add the mcp route to a nextjs project

README.md

@@ -12,12 +12,12 @@ npm install @vercel/mcp-adapter
 yarn add @vercel/mcp-adapter
 # or
 pnpm add @vercel/mcp-adapter
+# or
+bun add @vercel/mcp-adapter
 ```
 
 ## Next.js Usage
 
-1. Create an API route for MCP communication:
-
 ```typescript
 // app/api/[transport]/route.ts
 import { createMcpHandler } from '@vercel/mcp-adapter';
@@ -26,7 +26,9 @@ const handler = createMcpHandler(
     server.tool(
       'roll_dice',
       'Rolls an N-sided die',
-      { sides: z.number().int().min(2) },
+      { 
+        sides: z.number().int().min(2)
+      },
       async ({ sides }) => {
         const value = 1 + Math.floor(Math.random() * sides);
         return {
@@ -39,18 +41,62 @@ const handler = createMcpHandler(
     // Optional server options
   },
   {
-    // Optional configuration
+    // Optional redis config
     redisUrl: process.env.REDIS_URL,
-    // Set the basePath to where the handler is to automatically derive all endpoints
-    // This base path is for if this snippet is located at: /app/api/[transport]/route.ts
-    basePath: '/api',
+    // You need these endpoints
+    basePath: '/api', // this needs to match where the [transport] is located.
+    // @deprecated use 'basePath' instead
+    streamableHttpEndpoint?: string; // Endpoint for streamable HTTP transport
+    // @deprecated use 'basePath' instead
+    sseEndpoint?: string; // Endpoint for SSE transport
+    // @deprecated use 'basePath' instead
+    sseMessageEndpoint?: string; // Endpoint for SSE message transport
     maxDuration: 60,
     verboseLogs: true,
   }
 );
 export { handler as GET, handler as POST };
 ```
 
+## Integrating into your client
+
+When you want to use it in your MCP client of choice:
+
+### Claude Desktop
+[Official Docs](https://modelcontextprotocol.io/quickstart/user)
+
+In order to add an MCP server to Claude Desktop you need to edit the configuration file located at:
+
+```json
+"remote-example": {
+  "command": "npx",
+  "args": [
+    "mcp-remote",
+    "http://localhost:3000/api/mcp" // this is your app/api/[transport]/route.ts
+  ]
+}
+```
+
+macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
+Windows: %APPDATA%\Claude\claude_desktop_config.json
+If it does not exist yet, you may need to enable it under Settings > Developer.
+
+Restart Claude Desktop to pick up the changes in the configuration file. Upon restarting, you should see a hammer icon in the bottom right corner of the input box.
+
+### Cursor
+[Official Docs](https://docs.cursor.com/context/model-context-protocol) 
+
+The configuration file is located at ~/.cursor/mcp.json.
+
+As of version 0.48.0, Cursor supports unauthed SSE servers directly. If your MCP server is using the official MCP OAuth authorization protocol, you still need to add a "command" server and call mcp-remote.
+
+### Windsurf
+[Official Docs](https://docs.codeium.com/windsurf/mcp)
+
+The configuration file is located at ~/.codeium/windsurf/mcp_config.json.
+
+## Usage in your app
+
 1. Use the MCP client in your application:
 
 ```typescript
@@ -59,7 +105,7 @@ import { McpClient } from '@modelcontextprotocol/sdk/client';
 
 const client = new McpClient({
   // When using basePath, the SSE endpoint will be automatically derived
-  transport: new SSEClientTransport('/api/mcp/sse'),
+  transport: new SSEClientTransport('/api/mcp/mcp'),
 });
 
 // Use the client to make requests
@@ -73,12 +119,11 @@ The `initializeMcpApiHandler` function accepts the following configuration optio
 ```typescript
 interface Config {
   redisUrl?: string; // Redis connection URL for pub/sub
+  // @deprecated use streamableHttpEndpoint, sseEndpoint, sseMessageEndpoint
   basePath?: string; // string; // Base path for MCP endpoints
-  // @deprecated use 'basePath' instead
+  
   streamableHttpEndpoint?: string; // Endpoint for streamable HTTP transport
-  // @deprecated use 'basePath' instead
   sseEndpoint?: string; // Endpoint for SSE transport
-  // @deprecated use 'basePath' instead
   sseMessageEndpoint?: string; // Endpoint for SSE message transport
   maxDuration?: number; // Maximum duration for SSE connections in seconds
   verboseLogs?: boolean; // Log debugging information