Nuxt MCP Toolkit

<!-- automd:badges color="black" license name="@nuxtjs/mcp-toolkit" -->

<!-- /automd -->

A Nuxt module to easily create a Model Context Protocol (MCP) server directly in your Nuxt application. Define MCP tools, resources, and prompts with zero configuration - just create files and they're automatically discovered and registered.

✨ Features

<!-- automd:file src=".github/snippets/features.md" -->

• 🎯 Zero Configuration - Automatic discovery of tools, resources, prompts, and apps
• 📦 File-based - Organize definitions in intuitive directory structures
• 🚀 Multiple Handlers - Create multiple MCP endpoints in a single app
• 🖼️ MCP Apps - Ship interactive Vue UI widgets to MCP Apps-compatible hosts
• 🔍 Built-in Inspector - Visual debugging tool in Nuxt DevTools
• 📝 TypeScript First - Full type safety with auto-imports
• 🔒 Zod Validation - Built-in input/output validation

<!-- /automd -->

🧩 Agent Skills

Nuxt MCP Toolkit provides Agent Skills to help AI coding assistants build and manage MCP servers in your Nuxt application.

Installation

Install the skill from the published documentation site (Docus Agent Skills):

npx skills add https://mcp-toolkit.nuxt.dev

What it does

Once installed, your AI assistant will:

• Setup and configure MCP servers in your Nuxt apps
• Create tools, resources, and prompts following best practices
• Review your MCP implementation for anti-patterns and improvements
• Troubleshoot auto-imports, endpoints, and validation issues
• Create eval suites to verify tool selection

Examples

Setup an MCP server in my Nuxt app
Create a tool to fetch user data
Review my MCP implementation

Learn more about the skill →

🚀 Installation

<!-- automd:file src=".github/snippets/installation.md" -->

Use nuxt to install the module automatically:

npx nuxt add mcp

Or install manually:

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

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

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

# bun
bun add -D @nuxtjs/mcp-toolkit zod

<!-- /automd -->

📖 Documentation

📖 Full Documentation →

🤝 Contributing

<!-- automd:file src=".github/snippets/contributing.md" -->

Contributions are welcome! Feel free to open an issue or submit a pull request.

# Install dependencies
pnpm install

# Generate type stubs
pnpm run dev:prepare

# Start the playground
pnpm run dev

# Run tests
pnpm run test

<!-- /automd -->

❓ Questions & Support

<!-- automd:file src=".github/snippets/support.md" -->

• Issues: Open an issue for bugs or feature requests
• X: Follow @hugorcd for updates

<!-- /automd -->

📄 License

<!-- automd:file src=".github/snippets/license.md" -->

Published under the MIT license.

Made by @HugoRCD and community 💛

<a href="https://github.com/nuxt-modules/mcp-toolkit/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=nuxt-modules/mcp-toolkit" />
</a>

<!-- /automd -->