Nuxt MCP Toolkit

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

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

🧩 Agent Skills

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

Installation

npx skills add nuxt-modules/mcp-toolkit

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

Use nuxt to install the module automatically:

npx nuxt module add mcp-toolkit

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

📖 Documentation

📖 Full Documentation →

🤝 Contributing

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

❓ Questions & Support

Issues: Open an issue for bugs or feature requests
Discussions: Join the discussion for questions and ideas
X: Follow @hugorcd for updates

📄 License

Published under the MIT license.

Made by @HugoRCD and community 💛