@iris-eval/mcp-server 0.1.6 → 0.1.8

package/README.md

@@ -1,8 +1,9 @@
 # Iris — The Agent Eval Standard for MCP
 
-[![GitHub stars](https://img.shields.io/github/stars/iris-eval/mcp-server?style=social)](https://github.com/iris-eval/mcp-server)
+[![Glama Score](https://glama.ai/mcp/servers/iris-eval/mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/iris-eval/mcp-server)
 [![npm version](https://img.shields.io/npm/v/@iris-eval/mcp-server)](https://npmjs.com/package/@iris-eval/mcp-server)
-[![npm downloads](https://img.shields.io/npm/dw/@iris-eval/mcp-server)](https://npmjs.com/package/@iris-eval/mcp-server)
+[![npm downloads](https://img.shields.io/npm/dt/@iris-eval/mcp-server)](https://npmjs.com/package/@iris-eval/mcp-server)
+[![GitHub stars](https://img.shields.io/github/stars/iris-eval/mcp-server?style=social)](https://github.com/iris-eval/mcp-server)
 [![CI](https://github.com/iris-eval/mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/iris-eval/mcp-server/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Docker](https://img.shields.io/badge/Docker-ghcr.io-blue?logo=docker)](https://github.com/iris-eval/mcp-server/pkgs/container/mcp-server)
@@ -31,9 +32,11 @@ Iris evaluates all of it.
 | **Cost Visibility** | Aggregate cost across all agents over any time window. Set budget thresholds. Get flagged when agents overspend. |
 | **Web Dashboard** | Real-time dark-mode UI with trace visualization, eval results, and cost breakdowns. |
 
+**Requires Node.js 20 or later.** Check with `node --version`.
+
 ## Quickstart
 
-Add Iris to your Claude Desktop (or Cursor, Claude Code, Windsurf) MCP config:
+Add Iris to your MCP config. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible agent.
 
 ```json
 {
@@ -55,10 +58,37 @@ npx @iris-eval/mcp-server --dashboard
 # Open http://localhost:6920
 ```
 
+<details>
+<summary><strong>Setup by tool</strong></summary>
+
+#### Claude Desktop
+
+Edit your MCP config file:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add the JSON config above, then restart Claude Desktop.
+
+#### Claude Code
+
+```bash
+claude mcp add --transport stdio iris-eval -- npx @iris-eval/mcp-server
+```
+
+Then restart the session (`/clear` or relaunch) for tools to load.
+
+> **Windows note:** Do *not* use `cmd /c` wrapper — it causes path parsing issues. The `npx` command works directly.
+
+#### Cursor / Windsurf
+
+Add to your workspace `.cursor/mcp.json` or global MCP settings using the JSON config above.
+
+</details>
+
 ### Other Install Methods
 
 ```bash
-# Global install
+# Global install (recommended for persistent data and faster startup)
 npm install -g @iris-eval/mcp-server
 iris-mcp --dashboard
 
@@ -66,6 +96,8 @@ iris-mcp --dashboard
 docker run -p 3000:3000 -v iris-data:/data ghcr.io/iris-eval/mcp-server
 ```
 
+> **Tip:** Global install (`npm install -g`) stores traces persistently at `~/.iris/iris.db`. With `npx`, traces persist in the same location, but startup is slower due to package resolution.
+
 ## MCP Tools
 
 Iris registers three tools that any MCP-compatible agent can invoke:
@@ -142,6 +174,68 @@ iris-mcp --transport http --port 3000 --api-key "$(openssl rand -hex 32)" --dash
 
 </details>
 
+<details>
+<summary><strong>Troubleshooting</strong></summary>
+
+### Iris won't start / `ERR_MODULE_NOT_FOUND`
+
+You may have a cached older version. Clear the npx cache and retry:
+
+```bash
+npx --yes @iris-eval/mcp-server@latest
+```
+
+Or install globally to avoid cache issues entirely:
+
+```bash
+npm install -g @iris-eval/mcp-server@latest
+```
+
+### Tools not showing up in Claude Code
+
+MCP tools only load at session start. After adding iris-eval, restart the session with `/clear` or relaunch the terminal.
+
+### Version check
+
+Verify which version is running:
+
+```bash
+npx @iris-eval/mcp-server --help
+# Shows "Iris MCP-Native Agent Eval & Observability Server vX.Y.Z"
+```
+
+### Updating
+
+```bash
+# If using npx (clears cache and fetches latest)
+npx --yes @iris-eval/mcp-server@latest
+
+# If installed globally
+npm update -g @iris-eval/mcp-server
+```
+
+### Node.js version
+
+Iris requires Node.js 20 or later. Node 18 reached EOL in April 2025 and is not supported.
+
+```bash
+node --version  # Must be v20.x or v22.x+
+```
+
+### Windows: `cmd /c` not needed
+
+Claude Code's `/doctor` may suggest wrapping npx with `cmd /c`. This is not needed and causes path parsing issues. Use `npx` directly:
+
+```bash
+# Correct
+claude mcp add --transport stdio iris-eval -- npx @iris-eval/mcp-server
+
+# Wrong (causes /c to be parsed as a path)
+claude mcp add --transport stdio iris-eval -- cmd /c "npx @iris-eval/mcp-server"
+```
+
+</details>
+
 ---
 
 If Iris is useful to you, [consider starring the repo](https://github.com/iris-eval/mcp-server) — it helps others find it.

package/dist/config/defaults.js

@@ -3,7 +3,7 @@ import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 const irisHome = join(homedir(), '.iris');
 // Read version from package.json to avoid hardcoded drift
-let pkgVersion = '0.1.4';
+let pkgVersion = '0.1.8';
 try {
     const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
     pkgVersion = pkg.version;

package/dist/dashboard/assets/index-C9BwWthL.css

@@ -0,0 +1 @@
+:root{--bg-primary:#0a0a0b;--bg-secondary:#141416;--bg-tertiary:#1c1c1f;--bg-hover:#252528;--text-primary:#fafafa;--text-secondary:#a1a1aa;--text-muted:#71717a;--accent-primary:#0d9488;--accent-primary-hover:#14b8a6;--accent-success:#22c55e;--accent-error:#ef4444;--accent-warning:#f59e0b;--accent-tool:#3b82f6;--accent-llm:#a855f7;--border-color:#27272a;--border-radius:8px;--border-radius-sm:4px;--border-radius-lg:12px;--font-sans:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;--font-mono:"JetBrains Mono", "Fira Code", monospace;--font-size-xs:.75rem;--font-size-sm:.875rem;--font-size-base:1rem;--font-size-lg:1.125rem;--font-size-xl:1.25rem;--font-size-2xl:1.5rem;--font-size-3xl:2rem;--space-1:.25rem;--space-2:.5rem;--space-3:.75rem;--space-4:1rem;--space-5:1.25rem;--space-6:1.5rem;--space-8:2rem;--space-10:2.5rem;--space-12:3rem;--shadow-sm:0 1px 2px #0000004d;--shadow-md:0 4px 6px #0006;--shadow-lg:0 10px 15px #00000080;--transition-fast:.15s ease;--transition-base:.2s ease}*,:before,:after{box-sizing:border-box;margin:0;padding:0}html,body,#root{width:100%;height:100%}body{font-family:var(--font-sans);font-size:var(--font-size-base);color:var(--text-primary);background-color:var(--bg-primary);-webkit-font-smoothing:antialiased;line-height:1.5}a{color:var(--accent-primary);text-decoration:none}a:hover{color:var(--accent-primary-hover)}button{cursor:pointer;font-family:inherit}input,select{font-family:inherit;font-size:inherit}code,pre{font-family:var(--font-mono)}::-webkit-scrollbar{width:8px;height:8px}::-webkit-scrollbar-track{background:var(--bg-primary)}::-webkit-scrollbar-thumb{background:var(--border-color);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--text-muted)}