Next.js Docs MCP

🚀 Next.js Docs MCP

A Model Context Protocol (MCP) server that offers all Next.js documentation URLs to AI agents like Claude for intelligent document selection. It features a comprehensive static database of Next.js documentation pages, allowing AI agents to analyze and pick the most relevant docs based on user queries.

✨ Features

• AI Agent Integration: Offers all documentation URLs for Claude and other AI agents to analyze and select relevant documents.
• Comprehensive Static Database: Holds over 200 Next.js documentation URLs across all categories.
• No External Dependencies: A pure static URL database that requires no API calls or crawling.
• Claude-Optimized: Specially designed for Claude to intelligently select relevant documentation.
• npx-Ready: No local installation needed - run via npx from any MCP client.

📦 Installation

Requirements

• Node.js 18 or newer
• VS Code, Cursor, Windsurf, Claude Desktop, Goose, LM Studio, or any other MCP client

Installation Steps

Standard config works in most tools:

{
  "mcpServers": {
    "nextjs-docs-mcp": {
      "command": "npx",
      "args": ["@taiyokimura/nextjs-docs-mcp@latest"]
    }
  }
}

Install in VS Code Install in VS Code Insiders

Client-Specific Setup

claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest

claude mcp remove nextjs-docs-mcp

code --add-mcp '{"name":"nextjs-docs-mcp","command":"npx","args":["@taiyokimura/nextjs-docs-mcp@latest"]}'

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nextjs-docs-mcp": {
      "type": "local",
      "command": [
        "npx",
        "@taiyokimura/nextjs-docs-mcp@latest"
      ],
      "enabled": true
    }
  }
}

📚 Documentation

Available Tools

get_all_docs

Get all Next.js documentation URLs for AI agents to analyze and select relevant ones.

Parameters:

• None required

Description: This tool returns a comprehensive list of all Next.js documentation URLs organized by categories. AI agents like Claude can use this list to analyze user queries and select the most relevant documentation pages. The tool provides structured data including titles, URLs, descriptions, and categories for intelligent document selection.

Response Format: The tool returns a formatted list containing:

• Document titles
• Direct URLs to Next.js documentation
• Brief descriptions
• Category classifications
• Total count of available documents

💻 Usage Examples

Basic Usage

Get all Next.js documentation URLs:

{
  "tool": "get_all_docs"
}

Advanced Usage

Claude Integration Example:

1. User asks: "Next.jsのエラーを解消したいです"
2. Claude calls: get_all_docs
3. MCP server returns: All 200+ Next.js documentation URLs with titles, descriptions, and categories
4. Claude analyzes the list and selects relevant documents:
   • "Getting Started: Error Handling"
   • "Routing: Error Handling"
   • "API Routes Error Handling"
5. Claude provides targeted documentation links to the user

Integration with Claude Code:

# Used within Claude Code
claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest

Then Claude can automatically call the tool when users ask Next.js-related questions.

🔧 Technical Details

Building the Package

npm run build

Publishing to npm

1. Update the package name in package.json to your scope (e.g., @taiyokimura/nextjs-docs-mcp)
2. Build the project: npm run build
3. Publish: npm publish

Updating Documentation URLs

The server uses a static database of Next.js documentation URLs. To update or add new documentation URLs, modify the NEXTJS_DOCS_DATABASE object in src/index.ts. The database is organized by categories and contains 200+ documentation pages covering:

• Getting Started guides
• Routing (App Router & Pages Router)
• Data Fetching patterns
• API Routes
• Deployment guides
• Performance optimization
• Guides and best practices The static approach ensures fast response times and no external dependencies.

📄 License

MIT License

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for any improvements.