AI SDK 5 Migration MCP Server

An MCP server that helps you migrate from AI SDK 4.x to 5.0. This server has been designed to work with Cursor, but should work with any compatible MCP client.

Quick Start

Step 1: Configure Cursor

Create or edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "ai-sdk-5-migration": {
      "url": "https://ai-sdk-5-migration-mcp-server.vercel.app/api/mcp"
    }
  }
}

After saving the configuration, open the command palette (Cmd+Shift+P) and search for "View: Open MCP Settings". Verify that the new server appears in the list and is toggled to on.

Want to run it locally? See the Local Development section below.

Step 2: Run the migration

Open your project in Cursor and use this prompt:

Please migrate this project to AI SDK 5 using the ai-sdk-5-migration mcp server. Start by creating a checklist.

This prompt will:

1. Create a comprehensive migration checklist (AI_SDK_5_MIGRATION.md)
2. Guide the agent through all migration steps systematically
3. Search the official migration guides when needed for specific changes

Note: This has been tested with Cursor's auto model setting

How It Works

This server provides three MCP tools:

1. create-checklist - Returns a curl command that downloads a comprehensive migration checklist to AI_SDK_5_MIGRATION.md. This is much more efficient than having the model generate ~800 lines of text.

2. search-guide - Searches the official AI SDK 5 migration guide for code-related changes (APIs, imports, streaming, tools, etc.). Returns the most relevant sections with examples.

3. search-data-guide - Searches the data migration guide for database and persistence information (converting stored messages, dual-write patterns, schema changes).

The agent uses these tools automatically when you run the prompt above.

Local Development

If you prefer to run the server locally:

pnpm install
pnpm dev

Then update your .cursor/mcp.json to use http://localhost:3000/api/mcp instead of the hosted version.

Resources

• AI SDK Documentation
• AI SDK 5.0 Migration Guide
• Model Context Protocol

License

MIT