npm mcp-server-mcpindexstreamable-httpupdated 7d ago
The in-path trust gate for agent tool calls.
What can you do with mcpindex?
mcpindex.ai
The in-path trust gate for agent tool calls.
MCP tool contracts can change remotely with no version bump. mcpindex pins each contract and HOLDs the call when it drifts โ before your agent acts. Deterministic contract-diff on your host. Zero credential custody. Not a safety oracle.
Live site ยท Install gate ยท npx mcp-server-mcpindex ยท pip install mcpindex-gate ยท Remote MCP ยท Docs ยท Trust ยท Methodology
What you get
- In-path drift gate โ one command wires Claude Desktop / Claude Code / Cursor / Gemini CLI / Cline / Zed so each MCP server launches behind the gate. Local, fail-closed, default build egresses nothing.
curl -fsSL https://mcpindex.ai/install.sh | sh(inspect first with| less) ยท PyPI:mcpindex-gate - Advisory directory โ search, recommend, preflight (
/api/v1/preflight), and trust lookups over HTTP or as a drop-in MCP server (mcp-server-mcpindex). Screen verdicts are REVIEW / UNVERIFIED at v1; ALLOW / DENY are reserved in the contract. - Agent-readable surfaces โ
/llms.txt,/.well-known/mcp-index.json, JSON-LD, and a per-server page for every indexed server (live count at mcpindex.ai/stats).
The gate is the wedge. The directory is the corpus the gate can query โ also free.
Develop
Canonical local path:
/Volumes/GB990Pro/GBCode/mcpindex-web.
If you also havemcpindex-STALE-DO-NOT-DEPLOY/(or an oldmcpindex/clone), ignore it โ it is a blocked backup, not the live site.
npm install
node scripts/sync-registry.mjs # pull the registry: snapshot + removals + slug map
npm run dev # http://localhost:3000
Snapshot lives at data/snapshot.json (committed). Refresh anytime with the script.
Stack
- Next.js 16 (App Router) on Vercel
- Tailwind v4
- Local snapshot of
registry.modelcontextprotocol.io/v0/servers, refreshed daily via Vercel cron - Quality Score:
lib/quality.ts(open methodology - PRs welcome) - Search:
lib/search.ts(keyword now; embeddings v2 when OPENAI_API_KEY is wired)
Project layout
mcpindex/
โโโ app/ # Next.js routes
โ โโโ api/v1/ # Versioned public API
โ โโโ api/cron/ # Vercel-cron-driven endpoints
โ โโโ server/[slug]/ # per-server pages (top-N SSG + ISR)
โ โโโ best/[category]/ # curated category pages
โ โโโ ... # docs, trust, methodology, ledger, โฆ
โโโ components/ # Header, Footer, DriftGateDemo, LiveTicker, โฆ
โโโ lib/ # registry, quality, search, verdicts, installs, โฆ
โโโ scripts/ # sync-registry.mjs, build-slugmap.ts, honesty guard
โโโ data/ # snapshot.json (committed) + snapshots/ (cron-written)
โโโ mcp-server-mcpindex/ # the npm-distributed MCP directory client
โโโ โฆ
License
- Web app code: source-available, all-rights-reserved (prevents direct fork-and-deploy by competitors).
mcp-server-mcpindex(the npm package): MIT.- MCP Quality Score methodology: open and PR-friendly.
Affiliation
Unofficial. Not affiliated with Anthropic. The Model Context Protocol is open under MIT and trademarks remain with their owners. Server data comes from the official MCP registry.
Install
Add mcpindex to your client. Pick the one you use.
{
"servers": {
"mcp-server-mcpindex": {
"type": "http",
"url": "https://mcpindex.ai/api/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add mcp-server-mcpindex -- npx -y mcp-server-mcpindexcodex mcp add mcp-server-mcpindex -- npx -y mcp-server-mcpindexamp mcp add mcp-server-mcpindex -- npx -y mcp-server-mcpindex{
"mcpServers": {
"mcp-server-mcpindex": {
"command": "npx",
"args": [
"-y",
"mcp-server-mcpindex"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp-server-mcpindex": {
"command": "npx",
"args": [
"-y",
"mcp-server-mcpindex"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"mcp-server-mcpindex": {
"command": "npx",
"args": [
"-y",
"mcp-server-mcpindex"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp-server-mcpindex": {
"command": "npx",
"args": [
"-y",
"mcp-server-mcpindex"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp-server-mcpindex": {
"command": "npx",
"args": [
"-y",
"mcp-server-mcpindex"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp-server-mcpindex": {
"type": "local",
"command": "npx",
"args": [
"-y",
"mcp-server-mcpindex"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp-server-mcpindex": {
"command": {
"path": "npx",
"args": [
"-y",
"mcp-server-mcpindex"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y mcp-server-mcpindexRun `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation20/25
- Maintenance25/25
- Trust9/20
- Capability0/15
- Install experience15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 0 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 0.4.0Latest | Aug 18, 2026 |
| 0.3.13 | Jul 31, 2026 |
| 0.3.11 | Jul 16, 2026 |
| 0.3.10 | Jul 15, 2026 |
| 0.3.9 | Jul 15, 2026 |
| 0.3.8 | Jul 15, 2026 |
| 0.3.7 | Jul 15, 2026 |