Back to Home
Wolfe-Jam icon

faf-mcp

Verified Safe

by Wolfe-Jam

Overview

The server acts as a Model Context Protocol (MCP) provider to give AI assistants, like Claude, a persistent, structured, and deep understanding of a codebase, preventing context drift and optimizing AI performance.

Installation

Run Command
npx -y faf-mcp

Environment Variables

  • FAF_WORKING_DIR
  • MCP_WORKING_DIR
  • FAF_MCP_SHOW_ADVANCED
  • FAF_DEBUG
  • NO_COLOR
  • PORT
  • HOST
  • HOME
  • USERPROFILE
  • REPL_ID
  • REPL_OWNER
  • REPLIT_DB_URL
  • LOVABLE_PROJECT_ID
  • WIX_INSTANCE_ID
  • PROJECT_DOMAIN
  • PROJECT_ID
  • CODESANDBOX_ENV
  • STACKBLITZ_ENV
  • WARP_USE_SSH_AGENT
  • WARP_DEV
  • VSCODE_CLI
  • TERM_PROGRAM
  • CURSOR_EDITOR
  • CI
  • CONTAINER_ID

Security Notes

The `PathValidator` in `src/handlers/fileHandler.ts` proactively prevents path traversal and access to forbidden system directories, and enforces file size limits. While core functionalities are natively implemented in TypeScript (avoiding shell execution), a fallback mechanism in `src/handlers/engine-adapter.ts` uses `child_process.exec` for non-bundled commands. This fallback includes argument sanitization (`sanitizedArgs`) to mitigate injection risks, but shell execution always carries inherent risks. The `http-sse` transport defaults to listening on `0.0.0.0` with `cors` enabled for all origins, which is a permissive network configuration, common for dev tools but a consideration for broader exposure.

Similar Servers

Stats

Interest Score32
Security Score8
Cost ClassLow
Avg Tokens1500
Stars2
Forks1
Last Update2026-01-15

Tags

AI ContextCodebase OptimizationMCP ServerDevelopment ToolAI-Readiness