@goftf/mcp-server

MCP server for the goFTF Context Engine. Query your indexed codebase from Claude Desktop, Cursor, and other MCP-compatible AI tools.

Quick Start

1. Get your API key

Sign in at goftf.ai/portal/settings and create an API key.

2. Add to your MCP client

Claude Desktop — edit claude_desktop_config.json:

{
  "mcpServers": {
    "goftf": {
      "command": "npx",
      "args": ["-y", "@goftf/mcp-server"],
      "env": {
        "GOFTF_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor — add to MCP settings:

{
  "mcpServers": {
    "goftf": {
      "command": "npx",
      "args": ["-y", "@goftf/mcp-server"],
      "env": {
        "GOFTF_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

3. Query your codebase

Once configured, ask your AI assistant questions like:

• "How does authentication work?" → returns code facts with file paths and function names
• "Where is the database connection pool initialized?" → navigates to the relevant entry points
• "Trace the request handling pipeline" → BFS navigation through call graph and imports

Tools

query_codebase

Natural language query against your indexed codebase. Returns:

• Code Facts — verified extracts referencing specific functions, structs, and types
• Entry Points — seed files ranked by relevance with source attribution
• File Structure — AST metadata (function/class names) for visited files
• Coverage Gaps — identifies areas the navigation may have missed

Configuration

| Environment Variable | Required | Default | Description | |---------------------|----------|---------|-------------| | GOFTF_API_KEY | Yes | — | Your API key from goftf.ai/portal/settings | | GOFTF_API_URL | No | https://api.goftf.ai | API base URL (for self-hosted) | | GOFTF_TIMEOUT_MS | No | 60000 | Request timeout in milliseconds |

Requirements

• Node.js 18+
• An active goFTF account with an indexed project

License

MIT