代码文档搜索分析工具

{
  "mcpServers": {
    "preflight": {
      "command": "npx",
      "args": ["preflight-mcp"]
    }
  }
}

1. preflight_create_bundle   → Create bundle from source
2. preflight_get_overview    → Understand project structure
3. preflight_search_and_read → Find specific code/docs
4. preflight_lsp             → Navigate code (definitions, references) (requires LSP enabled)
5. preflight_check           → Check code quality

// GitHub repo
{"repos": [{"kind": "github", "repo": "owner/repo"}]}

// Local directory
{"repos": [{"kind": "local", "repo": "local/myproj", "path": "C:\\code\\myproj"}]}

// Web documentation
{"repos": [{"kind": "web", "url": "https://docs.example.com"}]}

// PDF (online or local)
{"repos": [{"kind": "pdf", "url": "https://arxiv.org/pdf/2512.14982"}]}
{"repos": [{"kind": "pdf", "path": "C:\\docs\\paper.pdf"}]}

{"bundleId": "abc123", "query": "authentication middleware", "scope": "code"}

{"path": "/home/user/project", "checks": ["security", "deadcode", "circular"]}

{"action": "definition", "file": "/path/to/file.py", "line": 42, "column": 10}
{"action": "references", "file": "/path/to/file.ts", "line": 15, "column": 5}

// Index bundle
{"bundleId": "abc123", "index": true}

// Query with hierarchical expansion (default)
{"bundleId": "abc123", "question": "What is the main contribution?"}

// Cross-validation: call twice, compare answers
{"bundleId": "abc123", "question": "..."}  // First: default LLM
{"bundleId": "abc123", "question": "...", "useVerifierLlm": true}  // Second: verifier LLM

// List all indexed content
{"action": "list"}

// View statistics
{"action": "stats"}

// Delete by content hash
{"action": "delete", "contentHash": "77b44fcb..."}

// Delete ALL indexed content (use with caution)
{"action": "delete_all"}

// Search with preset (AI mainstream papers from last 2 days, brief mode)
{"preset": "ai_mainstream", "daysBack": 2, "brief": true}

// Search with custom query
{"query": "ti:\"reinforcement learning\" AND cat:cs.AI", "maxResults": 20}

// Get full details by ID
{"idList": ["2301.07041", "2312.12456"]}

// Translate titles and summaries to Chinese
{"preset": "ai_mainstream", "daysBack": 1, "translate": true}

// Save results to file
{"preset": "llm", "daysBack": 7, "outputFile": "papers.md"}

// Download PDFs
{"idList": ["2601.20732", "2601.20745"], "outputDir": "D:/papers/"}

// Add memory
{"action": "add", "layer": "episodic", "content": "User prefers TypeScript over JavaScript", "metadata": {"type": "preference", "tags": ["coding-style"]}}

// Search memories
{"action": "search", "query": "coding preferences", "layers": ["semantic", "procedural"]}

// Get memory statistics
{"action": "stats"}

// List memories
{"action": "list", "layer": "procedural", "limit": 10}

// Update memory metadata
{"action": "update", "memoryId": "mem_pro_xxx", "metadata": {"category": "workflow"}, "mergeMode": "replace"}

// Delete memory
{"action": "delete", "memoryId": "mem_epi_xxx"}

// Extract facts from memories
{"action": "reflect", "reflectType": "extract_facts", "sourceIds": ["mem_epi_1", "mem_epi_2"]}

// Extract patterns from semantic memories
{"action": "reflect", "reflectType": "extract_patterns"}

// Compress episodic memories
{"action": "reflect", "reflectType": "compress", "compressStrategy": {"layer": "episodic", "maxCount": 10}}

// Garbage collect old/unused memories
{"action": "gc", "gcOptions": {"layers": ["episodic"], "maxAgeDays": 30, "minAccessCount": 1, "dryRun": false}}

{
  "vlmEnabled": true,
  "vlmApiBase": "https://api.openai.com/v1",
  "vlmApiKey": "sk-xxx",
  "vlmModel": "gpt-4o",

  "llmEnabled": true,
  "llmApiBase": "https://api.openai.com/v1",
  "llmApiKey": "sk-xxx",
  "llmModel": "gpt-4o-mini",

  "verifierLlmApiBase": "https://api.openai.com/v1",
  "verifierLlmApiKey": "sk-xxx",
  "verifierLlmModel": "gpt-4o",

  "embeddingEnabled": true,
  "embeddingProvider": "openai",
  "embeddingApiBase": "https://api.openai.com/v1",
  "embeddingApiKey": "sk-xxx",
  "embeddingModel": "text-embedding-3-small",

  "chromaUrl": "http://localhost:8000",

  "pdfChunkingStrategy": "semantic",
  "pdfChunkLevel": 2,

  "mineruEnabled": true,
  "mineruApiBase": "https://mineru.net",
  "mineruApiKey": "your-mineru-key",

  "memory": {
    "enabled": true,
    "userId": "optional-user-override"
  }
}

# Storage
PREFLIGHT_STORAGE_DIR=~/.preflight-mcp/bundles
PREFLIGHT_STORAGE_DIRS=/path/to/storage1;/path/to/storage2  # Multiple storage (semicolon-separated)
PREFLIGHT_ANALYSIS_MODE=none|quick|full

# Limits
PREFLIGHT_MAX_FILE_BYTES=524288      # 512KB
PREFLIGHT_MAX_TOTAL_BYTES=52428800   # 50MB

# Semantic Search
PREFLIGHT_SEMANTIC_SEARCH=true
PREFLIGHT_EMBEDDING_PROVIDER=ollama|openai
PREFLIGHT_OLLAMA_HOST=http://localhost:11434
PREFLIGHT_OLLAMA_MODEL=nomic-embed-text
PREFLIGHT_OPENAI_API_KEY=sk-xxx

# LSP
PREFLIGHT_LSP_ENABLED=true

# HTTP API
PREFLIGHT_HTTP_ENABLED=true
PREFLIGHT_HTTP_PORT=37123

# VLM (Vision-Language Model for PDF analysis)
PREFLIGHT_VLM_ENABLED=true
VLM_API_KEY=sk-xxx

# LLM (for knowledge cards and RAG synthesis)
PREFLIGHT_LLM_ENABLED=true
PREFLIGHT_LLM_API_KEY=sk-xxx

# Verifier LLM (for RAG cross-validation)
PREFLIGHT_VERIFIER_LLM_API_KEY=sk-xxx

# MinerU (PDF parsing API)
PREFLIGHT_MINERU_ENABLED=true
PREFLIGHT_MINERU_API_KEY=your-key

# Memory System
PREFLIGHT_MEMORY_ENABLED=true
PREFLIGHT_USER_ID=optional-user-override

# PDF Chunking
PREFLIGHT_PDF_CHUNK_STRATEGY=semantic|token-based|hybrid
PREFLIGHT_PDF_CHUNK_LEVEL=2  # 1=chapter, 2=section, 3=subsection, 4=paragraph

# ChromaDB
PREFLIGHT_CHROMA_URL=http://localhost:8000

bundle/
├── OVERVIEW.md          # Project summary
├── START_HERE.md        # Quick start guide
├── AGENTS.md            # Agent-specific guidance
├── manifest.json        # Bundle metadata
├── search.db            # FTS5 search index
├── analysis/
│   ├── gof-patterns.json
│   ├── architectural.json
│   ├── test-examples.json
│   └── config.json
└── repos/
    └── owner~repo/      # Ingested source files

{
  "mcpServers": {
    "preflight": {
      "command": "node",
      "args": ["path/to/preflight-mcp/dist/index.js"],
      "env": {
        "PREFLIGHT_STORAGE_DIR": "~/.preflight-mcp/bundles"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "preflight": {
        "command": "node",
        "args": ["path/to/preflight-mcp/dist/index.js"]
      }
    }
  }
}

docker run -e PREFLIGHT_STORAGE_DIR=/bundles -v /host/bundles:/bundles preflight-mcp

npm install
npm run dev          # Start development server
npm run typecheck    # Type checking without compilation
npm run build        # Production build with security checks
npm run build:quick  # Quick build without checks
npm run start        # Run production build
npm test             # Run tests
npm run smoke        # Smoke test after build
npm run docs:generate # Generate API documentation
npm run docs:serve   # Serve documentation with watch mode