Skip to main content
Glama

@gaddario98/mcp-react-docs

MCP (Model Context Protocol) server che fornisce ad AI coding assistants la documentazione e il codice sorgente dei package React @gaddario98.

Packages serviti

Package

Descrizione

@gaddario98/react-core

Framework React modulare: state, forms, queries, pages, auth

@gaddario98/react-form

Form builder dinamico su TanStack Form + Jotai

@gaddario98/react-queries

Data fetching su TanStack Query + Jotai

@gaddario98/react-pages

Page orchestrator: forms + queries + SEO + lazy loading

Related MCP server: daisyui-mcp-server

Tools disponibili

Tool

Descrizione

list_packages

Elenca tutti i package con versione e descrizione

get_package_docs

Ritorna il README.md completo di un package

get_package_types

Ritorna le definizioni TypeScript (types.ts)

get_package_source

Legge qualsiasi file sorgente di un package

search_source

Cerca un pattern (regex) nei file sorgente

Configurazione per AI Tools

Gemini Code Assist

Aggiungi al file .gemini/settings.json del tuo workspace:

{
  "mcpServers": {
    "react-docs": {
      "command": "npx",
      "args": ["-y", "github:gaddario98/mcp-react-docs"],
      "env": {
        "GITHUB_TOKEN": "ghp_il_tuo_token_qui"
      }
    }
  }
}

Claude Code / Claude Desktop

Aggiungi a ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "react-docs": {
      "command": "npx",
      "args": ["-y", "github:gaddario98/mcp-react-docs"],
      "env": {
        "GITHUB_TOKEN": "ghp_il_tuo_token_qui"
      }
    }
  }
}

Cursor

In Cursor Settings → MCP Servers → Add:

  • Name: react-docs

  • Command: npx -y github:gaddario98/mcp-react-docs

VS Code + Copilot (settings.json)

{
  "mcp": {
    "servers": {
      "react-docs": {
        "command": "npx",
        "args": ["-y", "github:gaddario98/mcp-react-docs"],
        "env": {
          "GITHUB_TOKEN": "ghp_il_tuo_token_qui"
        }
      }
    }
  }
}

🔑 Come ottenere il GITHUB_TOKEN

Dato che l'MCP invia richieste direttamente a GitHub, senza un token incapperai nel limite di 60 richieste all'ora, limitando pesantemente o bloccando strumenti come search_source.

Per generare un Token:

  1. Accedi a GitHub e vai in Settings > Developer Settings > Personal access tokens > Tokens (classic) (o usa i Fine-grained tokens se preferisci).

  2. Clicca su Generate new token (classic).

  3. Assegna un nome (es. local_mcp_server).

  4. Nessuno scope particolare è obbligatorio se i repo (gaddario98/react-core, ecc.) sono pubblici. Se in futuro i repo diverranno privati, spunta l'accesso repo.

  5. Clicca generate e copia il token (inizierà con ghp_...).

  6. Aggiungilo all'interno dell'oggetto "env" in tutte le configurazioni del tuo Editor come mostrato negli esempi sopra. In Cursor puoi configurarlo dal setup dell'MCP Server nelle Settings UI.

Test con MCP Inspector

npx @modelcontextprotocol/inspector npx -y github:gaddario98/mcp-react-docs

Sviluppo

# Avvia il server in modalità watch
yarn dev

# Avvia normalmente
yarn start

Available Tools

5 tools
get_package_docsB

Get the full README.md documentation for a specific @gaddario98 React package

Inputs: packageId (required).

get_package_sourceA

Read the contents of a specific source file from a @gaddario98 React package. Use list_packages first to see available packages, then explore files.

Inputs: packageId (required), filePath.

get_package_typesB

Get the TypeScript type definitions (types.ts) for a specific @gaddario98 React package

Inputs: packageId (required).

list_packagesA

List all available @gaddario98 React packages with their descriptions and GitHub links

Inputs: no named parameters.

search_sourceA

Search for a pattern across all source files of a @gaddario98 React package using GitHub Code Search. Requires GITHUB_TOKEN environment variable for best results.

Inputs: pattern (required), packageId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation4/5

    Tools are largely distinct: list_packages for enumeration, get_package_docs for README, get_package_source for arbitrary files, search_source for pattern search. However, get_package_types overlaps with get_package_source since both can retrieve types.ts, which may cause occasional confusion.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern (list_, get_, search_), with clear and predictable wording.

    Tool Count5/5

    Five tools is well-scoped for a documentation retrieval server, covering listing, fetching docs/types/source, and search without redundancy.

    Completeness3/5

    Core operations are present, but there is no tool to list files within a package, making get_package_source difficult to use without guessing file paths. This notable gap limits exploratory workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      MCP server for the ReactUse library. Exposes 110+ React Hook signatures, examples, and API metadata so AI coding assistants can discover and use any hook from @reactuses/core directly.
      3
      1,069
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides tools to fetch live, version-accurate documentation, changelogs, examples, and method signatures for npm and PyPI packages, preventing AI coding agents from hallucinating stale APIs.
      7 npm
      ISC