Bigindexer

Name: Bigindexer
Author: ahmedxuhri

by ahmedxuhricommunityv0.1.2

BGI is a static architecture analysis MCP server for large codebases. It groups code units by behavioral role and emits architecture artifacts such as graph and fuse-boundary data for downstream analysis and MCP tools.

From the registry: Architecture-aware MCP context with boundaries, seams, impact scope, and BGI-TWIN guidance.

GitHub Repository

Install & configure

Prerequisites

required
Install Bigindexer from PyPI
Install the published Bigindexer package so the `bgi` command is available.
```
$ pip install bigindexer==0.1.3
```
https://pypi.org/project/bigindexer/
required
Generate BGI graph artifact
Run a scan on your repository to produce the graph JSON consumed by the MCP server.
```
$ bgi scan <path-to-repo> --lang auto --out bgi-graph.json
```
required
Generate fuse graph artifact
Produce the fuse graph JSON artifact used by the MCP server.
```
$ bgi scan <path-to-repo> --lang auto --fuse-graph fuse-graph.json
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `bigindexer` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Bigindexer from PyPI** — Install the published Bigindexer package so the `bgi` command is available. Run: `pip install bigindexer==0.1.3` (https://pypi.org/project/bigindexer/)
- **Generate BGI graph artifact** — Run a scan on your repository to produce the graph JSON consumed by the MCP server. Run: `bgi scan <path-to-repo> --lang auto --out bgi-graph.json`
- **Generate fuse graph artifact** — Produce the fuse graph JSON artifact used by the MCP server. Run: `bgi scan <path-to-repo> --lang auto --fuse-graph fuse-graph.json`

Canonical MCP server config (stdio transport):
- command: `bgi`
- args: ["mcp","--graph","<path-to-bgi-graph.json>","--fuse-graph","<path-to-fuse-graph.json>"]
- optional environment variables:
  - `BGI_TELEMETRY`: Opt-in anonymous telemetry flag. Leave unset for default off; set to `1` to enable telemetry. (example: `1`)

Note: The README presents the MCP server as a local stdio process invoked via `bgi mcp`. The server depends on pre-generated analysis artifacts (`bgi-graph.json` and `fuse-graph.json`), so scanning the target repository is a practical prerequisite before configuring the MCP server.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: The README presents the MCP server as a local stdio process invoked via `bgi mcp`. The server depends on pre-generated analysis artifacts (`bgi-graph.json` and `fuse-graph.json`), so scanning the target repository is a practical prerequisite before configuring the MCP server.