Skip to content

nuxt-modules/mcp-toolkit

Repository files navigation

Nuxt MCP Toolkit

Install MCP in Cursor Install MCP in VS Code

Nuxt MCP Toolkit

npm version npm downloads license

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

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

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

📄 License

Published under the MIT license.

Made by @HugoRCD and community 💛

About

Create MCP servers directly in your Nuxt application. Define tools, resources, and prompts with a simple and intuitive API.

Topics

Resources

License

Stars

Watchers

Forks

Contributors