Big Indexer MCP server

by ahmedxuhri·io.github.ahmedxuhri/bigindexer·v0.1.2·3 stars

No reviews yet

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

A85/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A85/100

full report

Adoption

Growing

3 stars24 downloads/wk

Reviews

Write one

Nobody has reviewed Big Indexer yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Big Indexer tools (12)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

architecture_summary
Get compact architecture summary for context injection.
behavioral_twins
Return top behavioral twin candidates ranked by COV overlap.
boundary_edges
Get fuse boundary edges touching a file or cluster.
classify_prompt
Classify a prompt into scope and retrieval requirements.
cluster_of_file
Get architectural cluster data for a file path.
guided_arch_context
Get staged architecture context with scope-first escalation gates.
high_coupling_seams
Get strongest cross-cluster seams for a file/cluster or whole repo.
impact_neighbors
Get likely architectural blast radius from symbol/file.
reload_artifacts
Reload graph and fuse artifacts from disk.
search_symbols
Search symbols via index DB if available, else graph fallback.
task_fingerprint
Translate natural-language task text into COV tokens.
twin_context
Return task COV + top twins + seam + rubric for implementation guidance.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan211 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 37 days ago12/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Big Indexer compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 85/100; higher than 70% of 48,255 servers
Tools: 12; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 3; more than 80% of 28,688 servers
Downloads a week: 24; more than 10% of 12,191 servers with a package

What its tools let an agent do: 12 read

Install Big Indexer in Claude Code, Cursor or VS Code

claude mcp add bigindexer -- uvx bigindexer

Add to Cursor

What the publisher says

From the Big Indexer repository's README, as published. We do not edit it. Read it on GitHub

BGI - Big Indexer

BGI is a static architecture analysis tool for large codebases. It groups code units by behavioral role and emits explicit architectural boundaries. Project domain: bigindexer.com

Use via MCP Registry

Big Indexer is published in the MCP Registry as io.github.ahmedxuhri/bigindexer.

pip install bigindexer==0.1.3
bgi mcp --graph bgi-graph.json --fuse-graph fuse-graph.json

Validation: https://bigindexer.com/validation

What problem this solves

Most architecture graphs fail at scale in two ways:

too many noisy edges
giant clusters that collapse unrelated components together

BGI is built to keep both under control, so the output remains usable on large repos.

What you can do with it

BGI groups units by behavioral role (COV tokens + DRS clustering) so likely component boundaries are visible.

"Where should this boundary be before we refactor?"

BGI surfaces high-coupling seams and fuse-boundary signals between clusters so integration risk is easier to spot.

"Which subsystem coupling is risky?"

BGI emits machine-readable artifacts (bgi-graph.json, fuse-graph.json) plus optional human context (bigindexer.md).

"How do we plug architecture data into automation?"

MCP tools (taskfingerprint, behavioraltwins, twin_context) ground prompts in in-repo behavior patterns.

"How do we make AI changes less random?"

Yes — use the dedicated action repo ahmedxuhri/bigindexer-pr-risk-bot to auto-comment PRs with blast radius, seams, and risk hints.

"Can I run this automatically on PRs as a live example?"

30-second demo

Run BGI on the included fixture repo:

git clone https://github.com/ahmedxuhri/bigindexer
cd bigindexer
pip install -e .
bgi scan tests/fixtures --lang python --out /tmp/bgi-example.json
head -50 /tmp/bgi-example.json

Observed result on this repository:

units: 12
edges: 14
clusters: 2
max cluster in sample: 6 units

One produced edge looks like:

{
  "source": "auth_module.py::AuthService::__init__",
  "target": "auth_module.py::AuthService::__del__",
  "key": "COV.INIT",
  "lock": "COV.TEARDOWN",
  "type": "HARD"
}

Why this matters: instead of raw syntax references only, you get behavioral relationships plus cluster structure that can drive architecture decisions.

Plain-English glossary

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Big Indexer: common questions

Is Big Indexer MCP server safe?: Yes, by our scan: it is graded A (85/100). Read the Big Indexer safety report
How do I install Big Indexer?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Big Indexer need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Big Indexer maintained?: The last commit was 75 days ago (2026-08-21). The latest release is v0.1.2.
How does Big Indexer compare with other MCP servers?: safety score 85/100 (higher than 70% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.