@mcpjam/inspector 0.3.8 → 0.8.0

package/.next/types/cache-life.d.ts

@@ -0,0 +1,141 @@
+// Type definitions for Next.js cacheLife configs
+
+declare module 'next/cache' {
+  export { unstable_cache } from 'next/dist/server/web/spec-extension/unstable-cache'
+  export {
+    revalidateTag,
+    revalidatePath,
+    unstable_expireTag,
+    unstable_expirePath,
+  } from 'next/dist/server/web/spec-extension/revalidate'
+  export { unstable_noStore } from 'next/dist/server/web/spec-extension/unstable-no-store'
+
+  
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"default"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 900 seconds (15 minutes)
+     *   expire:     never
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 15 minutes, start revalidating new values in the background.
+     * It lives for the maximum age of the server cache. If this entry has no traffic for a while, it may serve an old value the next request.
+     */
+    export function unstable_cacheLife(profile: "default"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"seconds"` profile.
+     * ```
+     *   stale:      0 seconds
+     *   revalidate: 1 seconds
+     *   expire:     60 seconds (1 minute)
+     * ```
+     * 
+     * This cache may be stale on clients for 0 seconds before checking with the server.
+     * If the server receives a new request after 1 seconds, start revalidating new values in the background.
+     * If this entry has no traffic for 1 minute it will expire. The next request will recompute it.
+     */
+    export function unstable_cacheLife(profile: "seconds"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"minutes"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 60 seconds (1 minute)
+     *   expire:     3600 seconds (1 hour)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 minute, start revalidating new values in the background.
+     * If this entry has no traffic for 1 hour it will expire. The next request will recompute it.
+     */
+    export function unstable_cacheLife(profile: "minutes"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"hours"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 3600 seconds (1 hour)
+     *   expire:     86400 seconds (1 day)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 hour, start revalidating new values in the background.
+     * If this entry has no traffic for 1 day it will expire. The next request will recompute it.
+     */
+    export function unstable_cacheLife(profile: "hours"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"days"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 86400 seconds (1 day)
+     *   expire:     604800 seconds (1 week)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 day, start revalidating new values in the background.
+     * If this entry has no traffic for 1 week it will expire. The next request will recompute it.
+     */
+    export function unstable_cacheLife(profile: "days"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"weeks"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 604800 seconds (1 week)
+     *   expire:     2592000 seconds (30 days)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 week, start revalidating new values in the background.
+     * If this entry has no traffic for 30 days it will expire. The next request will recompute it.
+     */
+    export function unstable_cacheLife(profile: "weeks"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"max"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 2592000 seconds (30 days)
+     *   expire:     never
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 30 days, start revalidating new values in the background.
+     * It lives for the maximum age of the server cache. If this entry has no traffic for a while, it may serve an old value the next request.
+     */
+    export function unstable_cacheLife(profile: "max"): void
+    
+    /**
+     * Cache this `"use cache"` using a custom timespan.
+     * ```
+     *   stale: ... // seconds
+     *   revalidate: ... // seconds
+     *   expire: ... // seconds
+     * ```
+     *
+     * This is similar to Cache-Control: max-age=`stale`,s-max-age=`revalidate`,stale-while-revalidate=`expire-revalidate`
+     *
+     * If a value is left out, the lowest of other cacheLife() calls or the default, is used instead.
+     */
+    export function unstable_cacheLife(profile: {
+      /**
+       * This cache may be stale on clients for ... seconds before checking with the server.
+       */
+      stale?: number,
+      /**
+       * If the server receives a new request after ... seconds, start revalidating new values in the background.
+       */
+      revalidate?: number,
+      /**
+       * If this entry has no traffic for ... seconds it will expire. The next request will recompute it.
+       */
+      expire?: number
+    }): void
+  
+
+  export { cacheTag as unstable_cacheTag } from 'next/dist/server/use-cache/cache-tag'
+}

package/.next/types/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/README.md

@@ -1,157 +1,96 @@
 <div align="center">
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://github.com/MCPJam/inspector/blob/main/client/public/mcp_jam_dark.png">
-  <source media="(prefers-color-scheme: light)" srcset="https://github.com/MCPJam/inspector/blob/main/client/public/mcp_jam_light.png">
-  <img width="250" alt="MCPJam logo" src="https://github.com/MCPJam/inspector/blob/main/client/public/mcp_jam_light.png">
+  <source media="(prefers-color-scheme: dark)" srcset="./public/mcp_jam_dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="./public/mcp_jam_light.png">
+  <img width="250" alt="MCPJam Inspector V1 logo" src="./public/mcp_jam_light.png">
 </picture>
 
 <br/>
 
-# MCPJam Inspector
-
-**The developer tool for testing and debugging MCP servers**
+## MCP Server Testing Tool
 
 [![npm version](https://img.shields.io/npm/v/@mcpjam/inspector?style=for-the-badge&color=blue)](https://www.npmjs.com/package/@mcpjam/inspector)
-[![npm downloads](https://img.shields.io/npm/dm/@mcpjam/inspector?style=for-the-badge&color=green)](https://www.npmjs.com/package/@mcpjam/inspector)
-[![Docker Pulls](https://img.shields.io/docker/pulls/mcpjam/mcp-inspector?style=for-the-badge)](https://hub.docker.com/r/mcpjam/mcp-inspector)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](https://opensource.org/licenses/Apache-2.0)
-[![Node.js](https://img.shields.io/badge/Node.js-22.7.5+-green.svg?style=for-the-badge&logo=node.js)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.8+-blue.svg?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Server-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/JEnDtz8X6z)
 
 </div>
 
----
-
-## Quick Start
-
-Get up and running in seconds with the MCPJam Inspector:
-
-```bash
-npx @mcpjam/inspector@latest
-```
+A developer tool for testing, debugging Model Context Protocol (MCP) servers. Test whether or not you built your MCP server correctly. The project is open source and fully compliant to the MCP spec.
 
-That's it! The inspector will launch automatically in your browser at `http://localhost:6274`.
-
-### Running with Docker
-
-You can also run the inspector using Docker. First, make sure you have Docker installed and running.
-
-Pull the latest image from Docker Hub:
-
-```bash
-docker pull mcpjam/mcp-inspector:main
-```
+## Key Features
 
-Then, run the container:
-
-```bash
-docker run --rm -p 6274:6274 -p 6277:6277 mcpjam/mcp-inspector:main
-```
-
-The inspector will be available in your browser at `http://127.0.0.1:6274`.
-
----
+| Feature                      | Description                                                                                                                              |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| **Full MCP Spec Compliance** | Test your MCP server's tools, resources, prompts, and OAuth 2. MCPJam is compliant with the latest MCP specs.                            |
+| **All transports supported** | Connect to any MCP server. MCPJam inspector supports STDIO, SSE, and Streamable HTTP transports.                                         |
+| **LLM Playground**           | Integrated chat playground with OpenAI, Anthropic Claude, and Ollama model support. Test how your MCP server would behave against an LLM |
+| **Debugging**                | Comprehensive logging, tracing, and error reporting for MCP server development                                                           |
+| **Developer Experience**     | Connect to multiple MCP servers. Save configurations. Upgraded UI/UX for modern dev experience.                                          |
 
 ## 📸 Screenshots
 
-<div align="center">
-<img width="1511" alt="MCPJam Inspector Interface" src="https://github.com/user-attachments/assets/ade8a46a-f738-4d32-ac85-260a5e22b90f" />
-</div>
-
----
+  <img alt="MCPJam Inspector Demo" src="./public/demo_1.png">
 
-## ✨ Core Features
+<details>
+<summary><strong>LLM Playground</strong></summary>
 
-This project is a fork of the [@modelcontextprotocol/inspector](https://github.com/modelcontextprotocol/inspector). Many of the features are the same but with some enhancements. Key features include:
+<img alt="LLM Chat Demo" src="./public/demo_2.png">
 
-- **STDIO / SSE / Streamable HTTP** - This inspector supports all three protocols. Connect to any MCP server.
-- **Tool Execution** - Run server tools with live parameter input. Easily debug errors.
-- **(New) LLM tool interaction** - Test your MCP server against a real LLM.
-- **Debugging tools** - Enhanced logging experience to debug your server.
-- **Quality of life improvements** - Save requests, multi-server connection, saved connections.
+</details>
 
-## 📋 Requirements
+<details>
+<summary><strong>Connect to any server</strong></summary>
 
-- **Node.js**: `^22.7.5` or higher
-- **npm**: `^10.0.0` or higher (comes with Node.js)
+<img alt="MCPJam Connection Demo" src="./public/demo_3.png">
 
----
+</details>
 
-## 🎯 Usage Examples
+## 🚀 Quick Start
 
-### Basic Usage
+Start up the MCPJam inspector:
 
 ```bash
-# Launch inspector with default settings
 npx @mcpjam/inspector
 ```
 
-### Connect to Local Server
-
-```bash
-# Connect to a server built at build/index.js
-npx @mcpjam/inspector node build/index.js
-```
-
-### Connect with Arguments
+Other commands:
 
 ```bash
-# Pass custom arguments to your server
-npx @mcpjam/inspector node server.js --port 3000 --debug
-```
+# Launch with custom port
+npx @mcpjam/inspector --port 4000
 
-### Using Configuration File
-
-```bash
-# Load servers from a config file
-npx @mcpjam/inspector --config ./my-config.json
+# Shortcut for starting MCPJam and an Ollama model
+npx @mcpjam/inspector --ollama llama3.2
 ```
 
-### Example Configuration File
-
-```json
-{
-  "mcpServers": {
-    "my-awesome-server": {
-      "command": "node",
-      "args": ["build/index.js"],
-      "env": {
-        "API_KEY": "your-api-key",
-        "DEBUG": "true"
-      }
-    },
-    "python-server": {
-      "command": "python",
-      "args": ["-m", "my_mcp_server"],
-      "env": {
-        "PYTHONPATH": "./src"
-      }
-    }
-  }
-}
-```
+## Requirements
 
----
+[![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg?style=for-the-badge&logo=node.js)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5+-blue.svg?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
+[![Next.js](https://img.shields.io/badge/Next.js-15.4+-black.svg?style=for-the-badge&logo=next.js)](https://nextjs.org/)
 
 ## 🏗️ Architecture
 
-The MCPJam Inspector is built as a modern monorepo with three main components:
+MCPJam Inspector V1 is built as a modern Next.js application with integrated MCP capabilities:
 
 ```
-📦 @mcpjam/inspector
-├── 🖥️  client/     # React + TypeScript frontend
-├── 🔧  server/     # Express.js backend with WebSocket support
-└── 🚀  cli/        # Command-line interface
+📦 @mcpjam/inspector-v1
+├── 🎨 src/app/              # Next.js 15 App Router
+├── 🧩 src/components/       # React components with Radix UI
+├── 🔧 src/lib/             # Utility functions and helpers
+├── 🎯 src/hooks/           # Custom React hooks
+├── 📱 src/stores/          # Zustand state management
+├── 🎨 src/styles/          # Tailwind CSS themes
+└── 🚀 bin/                # CLI launcher script
 ```
 
 ### Tech Stack
 
-- **Frontend**: React 18, TypeScript, Tailwind CSS, Radix UI
-- **Backend**: Express.js, WebSocket (ws), CORS support
-- **CLI**: Node.js with shell integration
-- **Build Tools**: Vite, TSC, Concurrently
+- **Framework**: Next.js 15.4 with App Router and React 19
+- **Styling**: Tailwind CSS 4.x with custom themes and Radix UI components
+- **MCP Integration**: Mastra framework (@mastra/core, @mastra/mcp)
+- **AI Integration**: AI SDK with OpenAI, Anthropic, and Ollama providers
 
 ---
 
@@ -167,81 +106,55 @@ cd inspector
 # Install dependencies
 npm install
 
-# Start development servers
+# Start development server
 npm run dev
 ```
 
+The development server will start at `http://localhost:3000` with hot reloading enabled.
+
 ### Build for Production
 
 ```bash
-# Build all components
+# Build the application
 npm run build
 
-# Test the build
+# Start production server
 npm run start
 ```
 
-### Scripts for development
+### Available Scripts
 
-We put together these commands to help you build locally:
-| Script | Description |
-| ---------------------- | ------------------------------------------- |
-| `npm run dev` | Start development servers (client + server) |
-| `npm run build` | Build all components for production |
-| `npm run test` | Run test suite |
-| `npm run prettier-fix` | Format code with Prettier |
-| `npm run clean` | Clean all build artifacts and reinstall |
+| Script                 | Description                                     |
+| ---------------------- | ----------------------------------------------- |
+| `npm run dev`          | Start Next.js development server with Turbopack |
+| `npm run build`        | Build the application for production            |
+| `npm run start`        | Start the production server                     |
+| `npm run lint`         | Run ESLint code linting                         |
+| `npm run prettier-fix` | Format code with Prettier                       |
 
 ---
 
 ## 🤝 Contributing
 
-We welcome contributions! We thought the original inspector repository moved too slowly, so we wanted to build this project ourselves.
-
-1. **Clone** the repository
-2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
-3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
-4. **Push** to the branch (`git push origin feature/amazing-feature`)
-5. **Open** a Pull Request
-
-## 🗺️ Our Roadmap
-
-We're continuously improving the MCPJam Inspector. Here's what's coming next:
+We welcome contributions to MCPJam Inspector V1! Please read our [CONTRIBUTING.md](./CONTRIBUTING.md) for development guidelines and best practices.
 
-### UI/UX Improvements
+### Development Workflow
 
-- **Fix dark mode styling** - Improve run tool button appearance in dark mode
-- **Enhanced logging UX** - Address misleading red color for INFO logs
-
-### Core Features
-
-- **AI parameter fill** - Smart parameter completion using AI
-- **Collections** - Organize and group your MCP servers / tools
-- **Multi Provider support** - Support for other LLMs like ChatGPT
-
-### Technical Enhancements
-
-- **Security scanning** - Built-in vulnerability scanning tools
-- **Electron App** - Desktop application for enhanced user experience
-
-### Ecosystem
-
-- **Landing page improvements** - Update MCP Jam landing page
-- **Documentation expansion** - Enhanced guides and tutorials
-
-### Development Guidelines
-
-- Follow the existing code style (Prettier + ESLint)
-- Update documentation as needed
-
----
+1. **Fork** the repository
+2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
+3. **Develop** your changes with proper testing
+4. **Format** code with `npm run prettier-fix`
+5. **Lint** code with `npm run lint`
+6. **Commit** your changes (`git commit -m 'Add amazing feature'`)
+7. **Push** to your branch (`git push origin feature/amazing-feature`)
+8. **Open** a Pull Request
 
 ## 📚 Resources
 
-- **🌐 Website**: [mcpjam.com](https://mcpjam.com)
-- **📖 Documentation**: [MCP Protocol Docs](https://modelcontextprotocol.io/)
-- **🐛 Issues**: [GitHub Issues](https://github.com/mcpjam/inspector/issues)
-- **💬 Discussions**: [GitHub Discussions](https://github.com/mcpjam/inspector/discussions)
+- **💬 Discord**: [Join the MCPJam Community](https://discord.gg/JEnDtz8X6z)
+- **📖 MCP Protocol**: [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
+- **🔧 Mastra Framework**: [Mastra MCP Integration](https://github.com/mastra-ai/mastra)
+- **🤖 AI SDK**: [Vercel AI SDK](https://sdk.vercel.ai/)
 
 ---
 
@@ -253,6 +166,8 @@ This project is licensed under the **Apache License 2.0** - see the [LICENSE](LI
 
 <div align="center">
 
-**Made with ❤️ by the [MCPJam](https://mcpjam.com) team**
+**MCPJam Inspector V1** • Built with Next.js and ❤️ for the MCP community
+
+[🌐 Website](https://mcpjam.com) • [📖 Docs](https://modelcontextprotocol.io/) • [🐛 Issues](https://github.com/mcpjam/inspector-v1/issues)
 
 </div>