AI导哈

React文档服务

MCP服务器为AI编码助手提供React包的文档和源代码，包括核心框架、表单构建器、数据获取和页面编排等功能。

  • by gaddario98
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 gaddario98/mcp-react-docs

使用说明

@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

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

相关 MCP