Skip to main content
Glama
Sign In
Prathmesh2000

frontdex-mcp

by Prathmesh2000
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

frontdex-mcp

npm CI License: Apache-2.0

MCP server for Frontdex. It gives coding agents (Claude Code, Cursor, OpenCode, Antigravity, Hermes and any other MCP client) the project's living frontend index: components, pages, data flow, global state, API calls, styles, health issues and history.

flowchart LR
  Agent[Coding agent] -- stdio JSON-RPC --> MCP[frontdex-mcp]
  MCP -- createTools · loadConfig --> Core[frontdex<br/>installed in your app]
  Core --> Src[your source]

The server holds no analysis code of its own. Every answer comes from the core package's public API, and the core is a peer dependency, so the server always reads the index through the same version your project uses.

Install

Both packages are devDependencies of your app:

npm install --save-dev frontdex frontdex-mcp   # or pnpm add -D / yarn add -D / bun add -d
npx frontdex agents                            # writes .mcp.json, Cursor and OpenCode config, rules and hooks

frontdex agents registers npx frontdex mcp, which starts this package from your project, for Claude Code (.mcp.json), Cursor (.cursor/mcp.json), OpenCode (opencode.json), Antigravity (.agents/mcp_config.json) and, with --user-config, Hermes (~/.hermes/config.yaml). To register it by hand, add a stdio server named frontdex:

{ "mcpServers": { "frontdex": { "type": "stdio", "command": "npx", "args": ["frontdex", "mcp"] } } }

The exact file and format for each agent, plus the rules that tell the agent when to call these tools, are in frontdex's agent guide. frontdex-mcp -C <dir> (or frontdex mcp -C <dir>) targets another project root, for agents that start servers outside the project.

Related MCP server: codebase-rag

Tools

Tool

Returns

catalogue_overview

Counts, routers, folders, most shared components

catalogue_search

Components matching text and filters (uses:Button, is:shared, …)

catalogue_component

Full card: props, state, effects, renders, rendered by, pages

catalogue_dataflow

Props in per parent → store reads → state/effects → API calls → props out

catalogue_impact

Every component and page affected by changing one component

catalogue_page

A route's layouts, params and component tree, or all routes

catalogue_state

Redux slices, contexts, zustand stores with readers and writers

catalogue_api

Every API call grouped by endpoint

catalogue_styles

Where a CSS class is defined and used, or a component's styles

catalogue_health

Leaks, render loops, unsafe async, stale deps, dead code, with fixes

catalogue_rescan

Incremental rescan and what changed

catalogue_history

Knowledge-base snapshots, optionally for one component

catalogue_find_existing

Run before creating a component: existing ones with a similar name or props

catalogue_duplicates

Components that already look like duplicates of each other

catalogue_tokens

Design tokens and hard-coded values that should use them

catalogue_owners

CODEOWNERS, tests/stories and live git activity for a component

catalogue_adoption

Usage of a component across knowledge-base snapshots

catalogue_hooks

Custom hooks with what they read and call, and who uses them

catalogue_diff

The current change vs a git ref: components/pages changed, pages reached, new issues

catalogue_tests

Unit and E2E tests covering a component, page or file, with the command to run them

catalogue_enrich_next

Components whose docs are missing or stale, with the facts needed to write them

catalogue_enrich_write

Save docs for a component (purpose, props and how to pass them, functions, usage, notes) into the knowledge base

catalogue_docs

A component's saved docs, or docs coverage for the project

The server speaks the stateless 2026-07-28 MCP revision and the older initialize-handshake revisions (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05).

Contributing

See CONTRIBUTING.md; coding agents should read AGENTS.md. Short version: npm ci && npm test. The tests run against the frontdex devDependency and its examples/next-app. Tool behaviour lives in frontdex src/tools.js; this repo holds the tool schemas and the transport.

License and credit

Open source under the Apache License 2.0, created by Prathmesh Agrawal. Use it, change it and ship it, commercially or not; if you redistribute it or a modified version, keep the LICENSE and NOTICE files and mark the files you changed. Versions up to 0.2.x were published under MIT and remain available under it.

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • codebase-rag

    Ar-maan05
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables LLM agents to efficiently understand and navigate a codebase by providing semantic search over symbols and a reference graph, replacing expensive grep/glob calls with structured tools like definition lookup, caller/callee queries, and change-impact analysis.
    3
    MIT

  • assurance-memory

    yshaaban
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables coding agents to perform read-only source investigation via a local SQLite index, offering status, search, backlog, context, impact, and drift tools for TypeScript, JavaScript, and Java codebases.
    -

  • Verinoda

    Verinoda-Labs
    A
    license
    A
    quality
    B
    maintenance
    Enables users to build and continuously refresh a code index of a repository, then query it to answer architecture, impact, tracing and log questions with verifiable evidence lines. Also checks Java, Kotlin and TypeScript/JavaScript names against real sources and classpaths, and supports commit review and Minecraft/JVM analysis directly from an agent session.
    5
    1
    Apache 2.0