https://github.com/nuxt-modules/mcp-toolkit
Create MCP servers directly in your Nuxt application. Define tools, resources, and prompts with a simple and intuitive API.
https://github.com/nuxt-modules/mcp-toolkit
ai devtools mcp model-context-protocol nuxt nuxt-module
Last synced: 6 days ago
JSON representation
Create MCP servers directly in your Nuxt application. Define tools, resources, and prompts with a simple and intuitive API.
- Host: GitHub
- URL: https://github.com/nuxt-modules/mcp-toolkit
- Owner: nuxt-modules
- License: mit
- Created: 2025-11-08T21:01:45.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-01-09T15:59:40.000Z (2 months ago)
- Last Synced: 2026-01-10T18:50:11.524Z (2 months ago)
- Topics: ai, devtools, mcp, model-context-protocol, nuxt, nuxt-module
- Language: TypeScript
- Homepage: https://mcp-toolkit.nuxt.dev
- Size: 2.4 MB
- Stars: 93
- Watchers: 4
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
[](https://mcp-toolkit.nuxt.dev/mcp/deeplink)
[](https://mcp-toolkit.nuxt.dev/mcp/deeplink?ide=vscode)
# Nuxt MCP Toolkit
[](https://npmjs.com/package/@nuxtjs/mcp-toolkit)
[](https://npm.chart.dev/@nuxtjs/mcp-toolkit)
[](https://github.com/nuxt-modules/mcp-toolkit/blob/main/LICENSE)
A Nuxt module to easily create a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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](https://agentskills.io/) to help AI coding assistants build and manage MCP servers in your Nuxt application.
### Installation
```bash
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 →](https://mcp-toolkit.nuxt.dev/getting-started/agent-skills)
## 🚀 Installation
Use `nuxt` to install the module automatically:
```bash
npx nuxt module add mcp-toolkit
```
Or install manually:
```bash
# 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 →](https://mcp-toolkit.nuxt.dev)**
## 🤝 Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request.
```bash
# 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](https://github.com/nuxt-modules/mcp-toolkit/issues) for bugs or feature requests
- **Discussions**: [Join the discussion](https://github.com/nuxt-modules/mcp-toolkit/discussions) for questions and ideas
- **X**: Follow [@hugorcd](https://twitter.com/hugorcd) for updates
## 📄 License
Published under the [MIT](https://github.com/nuxt-modules/mcp-toolkit/blob/main/LICENSE) license.
Made by [@HugoRCD](https://github.com/HugoRCD) and [community](https://github.com/nuxt-modules/mcp-toolkit/graphs/contributors) 💛
