@mcpjam/inspector 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -8,38 +8,27 @@
8
8
 
9
9
  <br/>
10
10
 
11
- ## MCP Server Testing Tool
12
-
13
11
  www.mcpjam.com
14
12
 
15
13
  [![npm version](https://img.shields.io/npm/v/@mcpjam/inspector?style=for-the-badge&color=blue)](https://www.npmjs.com/package/@mcpjam/inspector)
16
14
  [![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)
17
15
  [![Discord](https://img.shields.io/badge/Discord-Join%20Server-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/JEnDtz8X6z)
18
16
 
19
- <p align="center">
20
- <a href="https://handbook.opencoreventures.com/catalyst-sponsorship-program/" target="_blank" rel="noopener noreferrer">
21
- <img src="./client/public/catalyst.png" alt="Catalyst Project" width="150" hspace="20">
22
- </a>
23
- <a href="https://resources.github.com/github-secure-open-source-fund/" target="_blank" rel="noopener noreferrer">
24
- <img src="./client/public/microsoft_sponsor.jpeg" alt="Microsoft" width="190" height=70 hspace="20">
25
- </a>
26
- </p>
27
-
28
17
  <br/>
29
18
  <br/>
30
19
  </div>
31
20
 
32
- 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.
21
+ A developer tool for testing, debugging Model Context Protocol (MCP) servers. It’s a great place to start evaluating an MCP server by inspecting the protocol handshake and getting a deterministic list of tools, resources, prompts from the server.
33
22
 
34
23
  ## Key Features
35
24
 
36
- | Feature | Description |
37
- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
38
- | **Full MCP Spec Compliance** | Test your MCP server's tools, resources, prompts, elicitation, and OAuth 2. MCPJam is compliant with the latest MCP specs. |
39
- | **All transports supported** | Connect to any MCP server. MCPJam inspector supports STDIO, SSE, and Streamable HTTP transports. |
40
- | **LLM Playground** | Integrated chat playground with OpenAI, Anthropic Claude, and Ollama model support. Test how your MCP server would behave against an LLM |
41
- | **Debugging** | Comprehensive logging, tracing, and error reporting for MCP server development |
42
- | **Developer Experience** | Connect to multiple MCP servers. Save configurations. Upgraded UI/UX for modern dev experience. |
25
+ | Feature | Description |
26
+ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
27
+ | **Protocol handshake testing** | Test your MCP server's tools, resources, prompts, elicitation, and OAuth 2. MCPJam is compliant with the latest MCP specs. |
28
+ | **All transports supported** | Connect to any MCP server. MCPJam inspector supports STDIO, SSE, and Streamable HTTP transports. |
29
+ | **LLM Playground** | Integrated chat playground with OpenAI, Anthropic Claude, and Ollama model support. Test how your MCP server would behave against an LLM |
30
+ | **Evals testing** | Simulate users flows to catch security vulnerabilities and performance regressions before your server hits production. |
31
+ | **Multiple server conenctions** | Connect to multiple MCP servers. Save configurations. Upgraded UI/UX for modern dev experience. |
43
32
 
44
33
  ## 📸 Screenshots
45
34
 
@@ -53,12 +42,19 @@ A developer tool for testing, debugging Model Context Protocol (MCP) servers. Te
53
42
  </details>
54
43
 
55
44
  <details>
56
- <summary><strong>Connect to any server</strong></summary>
45
+ <summary><strong>Evals and pen testing</strong></summary>
57
46
 
58
47
  <img alt="MCPJam Connection Demo" src="./client/public/demo_3.png">
59
48
 
60
49
  </details>
61
50
 
51
+ <details>
52
+ <summary><strong>Connect with OAuth</strong></summary>
53
+
54
+ <img alt="MCPJam Connection Demo" src="./client/public/demo_4.png">
55
+
56
+ </details>
57
+
62
58
  ## 🚀 Quick Start
63
59
 
64
60
  Start up the MCPJam inspector:
@@ -126,31 +122,6 @@ In the UI "MCP Servers" tab, click add server, select HTTP, then paste in your s
126
122
 
127
123
  [![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg?style=for-the-badge&logo=node.js)](https://nodejs.org/)
128
124
  [![TypeScript](https://img.shields.io/badge/TypeScript-5+-blue.svg?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
129
- [![Next.js](https://img.shields.io/badge/Next.js-15.4+-black.svg?style=for-the-badge&logo=next.js)](https://nextjs.org/)
130
-
131
- ## 🏗️ Architecture
132
-
133
- MCPJam Inspector V1 is built as a modern Next.js application with integrated MCP capabilities:
134
-
135
- ```
136
- 📦 @mcpjam/inspector-v1
137
- ├── 🎨 src/app/ # Next.js 15 App Router
138
- ├── 🧩 src/components/ # React components with Radix UI
139
- ├── 🔧 src/lib/ # Utility functions and helpers
140
- ├── 🎯 src/hooks/ # Custom React hooks
141
- ├── 📱 src/stores/ # Zustand state management
142
- ├── 🎨 src/styles/ # Tailwind CSS themes
143
- └── 🚀 bin/ # CLI launcher script
144
- ```
145
-
146
- ### Tech Stack
147
-
148
- - **Framework**: Next.js 15.4 with App Router and React 19
149
- - **Styling**: Tailwind CSS 4.x with custom themes and Radix UI components
150
- - **MCP Integration**: Mastra framework (@mastra/core, @mastra/mcp)
151
- - **AI Integration**: AI SDK with OpenAI, Anthropic, and Ollama providers
152
-
153
- ---
154
125
 
155
126
  ## 🛠️ Development
156
127
 
@@ -229,13 +200,3 @@ This project is licensed under the **Apache License 2.0** - see the [LICENSE](LI
229
200
  [🌐 Website](https://mcpjam.com) • [📖 Docs](https://modelcontextprotocol.io/) • [🐛 Issues](https://github.com/MCPJam/inspector/issues)
230
201
 
231
202
  </div>
232
-
233
- # ⭐ Star History
234
-
235
- <a href="https://star-history.com/#MCPJam/inspector&Date">
236
- <picture>
237
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MCPJam/inspector&type=Date&theme=dark" />
238
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MCPJam/inspector&type=Date" />
239
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MCPJam/inspector&type=Date" />
240
- </picture>
241
- </a>