mcp-toolkit

Nuxt MCP Toolkit is a module that lets you expose Model Context Protocol (MCP) endpoints directly from within a Nuxt application. It automatically discovers and registers tools, resources, and prompts based on your file structure, enabling you to run multiple MCP endpoints in a single Nuxt app with zero configuration. The toolkit also provides a built-in inspector for visual debugging in Nuxt DevTools, benefits from TypeScript-first development with auto-imports, and validates inputs and outputs with Zod, helping you catch issues early in the development cycle. After installation, you can manage MCP endpoints by organizing your tools, resources, and prompts in your Nuxt project folders, and the module will wire them up automatically as MCP servers.

To use it, install Nuxt MCP Toolkit in your Nuxt project and run your Nuxt development server as usual. The toolkit will scan your project for MCP definitions and expose endpoints that your AI agents or clients can interact with. With support for multiple endpoints, you can host several distinct MCP servers within a single application (for example, separate endpoints for different domains or projects). The built-in inspector helps you visualize and debug the MCP flows during development, and the TypeScript-first approach provides strong typing and safer tool definitions throughout your MCP setup.

Prerequisites:

• Node.js installed (LTS version recommended)
• A Nuxt project (Nuxt 3 or Nuxt 2 with appropriate setup)

Installation steps:

1. Install the Nuxt MCP Toolkit module and its peer dependency:

# Using npm
npm install -D @nuxtjs/mcp-toolkit zod

# Using yarn
yarn add -D @nuxtjs/mcp-toolkit zod

# Using pnpm
pnpm add -D @nuxtjs/mcp-toolkit zod

2. Add the module to your Nuxt configuration (nuxt.config.*) if required by your Nuxt version, typically via:

export default {
  modules: ["@nuxtjs/mcp-toolkit"]
}

3. Start the development server as you normally would for Nuxt:

# npm
npm run dev

# yarn
yarn dev

4. (Optional) If you’re integrating with a tooling workflow like Agent Skills, follow the provided guides to ensure your MCP endpoints are correctly defined within your Nuxt app structure.

Note: The README examples show a minimal setup using npx to install or enable the tooling. The exact Nuxt integration may vary depending on your Nuxt version and project structure. Refer to the full documentation linked in the repository for version-specific steps.

Tips and notes:

• This module enables zero-configuration discovery of MCP tools, resources, and prompts by scanning your project files. Place your MCP definitions in the recommended directory structure so they’re automatically picked up.
• You can run multiple MCP endpoints in a single Nuxt app. Each endpoint corresponds to a separate server configuration within your Nuxt project.
• The toolkit includes a built-in inspector for debugging MCP flows within Nuxt DevTools. Use it to visualize requests, responses, and validation errors.
• Ensure Zod is installed (as shown in installation steps) to enable robust input/output validation.
• If you encounter issues with auto-imports or endpoint discovery, verify your file paths and naming conventions align with the toolkit’s discovery rules and consult the documentation for any Nuxt version-specific caveats.
• When deploying, consider how you expose MCP endpoints (e.g., within your app’s API routes or a dedicated server) and ensure proper authentication and access controls for your environment.