index

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 8 GitHub stars
Code Basarisiz
  • exec() — Shell command execution in src/cli/configFile.ts
  • os.homedir — User home directory access in src/cli/setup.tsx
  • process.env — Environment variable access in src/cli/setup.tsx
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Mintlify Index: retrieval engine and MCP server. Install: npx mint index

README.md

Mintlify Index

Real-time documentation retrieval for coding agents.

Mintlify Index answers implementation questions (syntax, configuration, migration, setup) with compact, cited context assembled from primary-source developer documentation and live web search. It ships as a hosted MCP server exposing a single context tool.

Quickstart

npx mint index

The interactive installer detects your coding agents and adds the hosted MCP server (https://index.mintlify.com/mcp) plus a usage rule so the agent reaches for it automatically. Supported clients:

  • Claude Code
  • Cursor
  • VS Code (Copilot)
  • Codex
  • OpenCode
  • Windsurf
  • Zed

Non-interactive setup:

npx mint index --claude --cursor --yes     # specific clients, skip prompts
npx mint index --project                   # write project-level config instead of global

Any other MCP client can be pointed at the server manually:

{
  "mcpServers": {
    "mintlify-index": {
      "type": "http",
      "url": "https://index.mintlify.com/mcp"
    }
  }
}

The context tool takes a query (plus optional product, includeDomains, excludeDomains, and a tokenBudget up to 6000) and returns a cited answer in one call.

How it works

query
  │
  ▼
router ────────────── LLM route decision against a catalog of indexed sites
  │
  ├───────────────┬─────────────────┐
  ▼               ▼                 │
mintlify leg    web leg             │  run concurrently or routed
(Chroma hybrid  (Exa search +       │
 search over     live contents)     │
 indexed docs)                      │
  └───────┬───────┘                 │
          ▼                         │
combine + rerank ── deterministic scoring, hosted reranker, LLM fallback
          │
          ▼
context assembly ── token-budget packing with query-centered snippets
          │
          ▼
MCP `context` tool
Directory Pipeline stage
src/retrieval/router.ts LLM query router deciding which leg(s) to serve
src/retrieval/engine.ts The engine: legs, blending, ranking, relevance cutoff, hydration
src/retrieval/webSearchProvider.ts Web leg over Exa
src/retrieval/reranker.ts Hosted + LLM rerankers, query-centered snippeting
src/retrieval/contextAssembly.ts Token-budget context packing
src/retrieval/operations.ts context / search / contents operations
src/retrieval/retrievalConfig.ts Tunable retrieval configuration
src/mcp/ MCP server: the context tool over streamable HTTP
src/cli/ The mint index installer (ships in the mint CLI)
src/internal/ Interfaces for Mintlify-platform components backing the hosted service

About this repo

This is a source release of the hosted service. It is not runnable standalone: docs ingestion, the Chroma corpus, auth, and infrastructure live in the Mintlify platform and are represented here by small interfaces in src/internal/. src/server.ts shows how the pieces wire together in production.

License

MIT

Yorumlar (0)

Sonuc bulunamadi