CodeFundi

Code Fundi

El mapa de código para agentes de IA, equipos y aplicaciones.

Servidor MCP de Code-Fundi

Un servidor de Protocolo de Contexto de Modelo (MCP) de nivel de producción para la API de Code-Fundi: un mapa de código y motor de radio de impacto para agentes de codificación de IA. Permite que cualquier asistente de IA compatible con MCP (Claude, Claude Code, Cursor, Windsurf, VS Code Copilot y más) busque, investigue, indexe y escanee repositorios de código mediante lenguaje natural, y vea qué rompe un cambio antes de que se publique.

Construido con FastMCP (TypeScript) y Zod para la validación de esquemas.

Primeros pasos para agentes de IA

Si usted es un agente de IA (o está configurando uno) y no hay CODEFUNDI_API_KEY establecido, debe autenticarse por sí mismo antes de usar herramientas de búsqueda, repositorios, chat u otras herramientas autenticadas. Las herramientas de autenticación (code-fundi-auth-*) funcionan sin una clave preexistente.

Qué ruta usar

Situación	Acción
CODEFUNDI_API_KEY está configurado en la configuración de MCP	Use cualquier herramienta de inmediato: el servidor la envía como X-API-Key en cada solicitud
Sin clave de API configurada	Ejecute el flujo de autenticación OTP siguiente (recomendado) o el inicio de sesión con contraseña

Configuración MCP de cero configuración (sin clave de API)

Puede iniciar el servidor MCP sin CODEFUNDI_API_KEY y autenticarse en tiempo de ejecución:

{
  "mcpServers": {
    "code-fundi": {
      "command": "npx",
      "args": ["-y", "@codefundi/code-fundi-mcp"]
    }
  }
}

Autenticarse con OTP (recomendado)

Code-Fundi usa autenticación respaldada por Supabase (POST /v2/auth/authenticate, /v2/auth/verify, /v2/auth/resend). Los correos OTP contienen un código de 6 dígitos — los enlaces mágicos no son compatibles en esta ruta.

1. Pídale al usuario humano su dirección de correo electrónico.
2. Llame a code-fundi-auth-authenticate con:
   • auth_mode: "otp"
   • email: el correo del usuario
   • should_create_user: true para una cuenta nueva, false para un usuario existente
3. Dígale al usuario que revise su bandeja de entrada para un código de 6 dígitos. La API puede devolver verification_required: true y api_key.key_state: "agent_pending" hasta que se complete la verificación.
4. Pídale al usuario el OTP de 6 dígitos (humano en el bucle — no puede adivinarlo ni omitir este paso).
5. Llame a code-fundi-auth-verify con el mismo email y el token (6 dígitos).
6. En caso de éxito, el servidor MCP configura automáticamente la clave de API en memoria para todas las llamadas de herramientas posteriores en esta sesión.

Si el código expiró o no se recibió, llame a code-fundi-auth-resend con el mismo email, y repita el paso 5.

Ejemplo de diálogo:

Agent: What email should I use to sign in to Code-Fundi?
User:  dev@example.com
Agent: [calls code-fundi-auth-authenticate] I've sent a 6-digit code to dev@example.com. Please paste it here.
User:  482913
Agent: [calls code-fundi-auth-verify] You're signed in. I can now search and index your repositories.

Inicio de sesión con contraseña (alternativa)

Para cuentas existentes con contraseña, llame a code-fundi-auth-authenticate con auth_mode: "password", el email del usuario, should_create_user: false y el parámetro password. El cliente MCP envía la contraseña solo en el encabezado X-CodeFundi-Auth-Password (nunca en el cuerpo JSON). La producción requiere HTTPS. Los usuarios recurrentes pueden recibir una clave de API activa de inmediato sin un paso de verificación separado.

Después de la autenticación

• La clave de API se mantiene en memoria durante toda la vida del proceso del servidor MCP. No se persiste entre reinicios del IDE o MCP.
• Recomiende al usuario agregar la clave a su configuración MCP como CODEFUNDI_API_KEY para que las futuras sesiones comiencen autenticadas.
• Se crean automáticamente una cuenta de nivel FREE y una clave de API en el primer registro.

Errores

Código de estado HTTP	Qué hacer
401 No autorizado	Sin clave válida — ejecute el flujo OTP anterior, o configure CODEFUNDI_API_KEY
429 Demasiadas solicitudes	Los endpoints de autenticación están limitados por IP; espere Retry-After segundos, luego reintente

Características

Cada herramienta a continuación está respaldada por el mismo mapa de código: dependencias estructurales, grafo de llamadas y radio de impacto, indexado una vez y consultado en milisegundos.

• 🔍 Búsqueda de código semántica y grep en su mapa de código indexado
• 🧠 Investigación impulsada por IA: búsqueda más análisis de IA en una sola llamada
• 📦 Gestión de repositorios: indexar, estado, README, listado, catálogo público
• 🛰️ Inteligencia de repositorios: mapa de dependencias entre repos, plano, Guardia de Radio de Impacto (análisis de impacto antes de fusionar)
• 📄 Documentación de archivos: documentación generada por IA para cualquier archivo indexado
• 📊 Estadísticas de uso: consulta de uso, actividad, desgloses por lenguaje
• 🔐 Autenticación impulsada por agente: registro/inicio de sesión mediante OTP sin claves preconfiguradas
• 💬 Chat de IA y conocimiento de modelos: conversación directa con la IA de Code-Fundi, catálogo de modelos y límites por nivel

Inicio rápido

Instalar desde npm (recomendado)

Instale el paquete (incluye un dist/ preconstruido). El binario code-fundi-mcp está en su PATH cuando se instala globalmente, o disponible mediante npx sin clonar el repositorio:

npm install -g @codefundi/code-fundi-mcp

O agréguelo a un proyecto:

npm install @codefundi/code-fundi-mcp

Instalar desde el código fuente (este repositorio)

git clone https://github.com/Code-Fundi/code-fundi-mcp.git
cd code-fundi-mcp
npm install
npm run build

Configurar

Opción A — clave de API (la más rápida): establezca su clave como variable de entorno:

export CODEFUNDI_API_KEY=your_api_key_here

Opción B — sin clave de API: omita la variable de entorno y deje que el agente se autentique en tiempo de ejecución. Consulte Primeros pasos para agentes de IA.

Ejemplo MCP de cero configuración (sin bloque env):

{
  "mcpServers": {
    "code-fundi": {
      "command": "npx",
      "args": ["-y", "@codefundi/code-fundi-mcp"]
    }
  }
}

Usar con Claude Desktop

Después de una instalación global (npm i -g @codefundi/code-fundi-mcp), apunte MCP al binario publicado (sin ruta a dist/index.js requerida):

{
  "mcpServers": {
    "code-fundi": {
      "command": "@codefundi/code-fundi-mcp",
      "env": {
        "CODEFUNDI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Si el binario no está en su PATH, use npx (descarga o usa el paquete local y ejecuta el mismo punto de entrada):

{
  "mcpServers": {
    "code-fundi": {
      "command": "npx",
      "args": ["-y", "@codefundi/code-fundi-mcp"],
      "env": {
        "CODEFUNDI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usar con Cursor

Mismo patrón que Claude: command más solo el args opcional, sin ruta manual al repositorio:

{
  "mcpServers": {
    "code-fundi": {
      "command": "npx",
      "args": ["-y", "@codefundi/code-fundi-mcp"],
      "env": {
        "CODEFUNDI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Al desarrollar dentro de este repositorio, puede ejecutar npm run dev o npx tsx src/index.ts sin compilar primero.

Modo de desarrollo

npm run dev                          # Run with tsx (no build needed)
npx fastmcp inspect src/index.ts    # Open MCP Inspector UI
npx fastmcp dev src/index.ts        # Test with MCP CLI

Referencia de herramientas (27 herramientas)

Cubre la API de Code-Fundi V2 para mapeo de código y análisis de radio de impacto: búsqueda (incluida búsqueda con chat / investigación), repositorios (lista, indexación, estado, readme, catálogo público), inteligencia de repositorios (mapa, plano, radio), archivos, historial, estadísticas, claves de API, autenticación, además del chat Fundi (POST /v1/fundi/chat) y el catálogo de modelos V2 / límites (GET /v2/models, GET /v2/models/limits).

Búsqueda

Herramienta	Descripción
code-fundi-search	Búsqueda semántica y grep en su mapa de código indexado, con filtros
code-fundi-research	Búsqueda más análisis sintetizado por IA del código coincidente

Repositorios

Herramienta	Descripción
code-fundi-list-repos	Lista de repositorios indexados con paginación
code-fundi-index-repo	Indexa un nuevo repositorio de GitHub en su mapa de código
code-fundi-repo-status	Verifica el estado de indexación del repositorio
code-fundi-repo-readme	Obtiene la documentación README del repositorio (obsoleto, prefiera el plano)
code-fundi-list-public-repos	Explore el catálogo global de repositorios públicos indexados (sin clave necesaria)

Inteligencia de repositorios

Herramienta	Descripción
code-fundi-repo-map	Mapa de dependencias entre repositorios: cómo se conectan realmente servicios y paquetes
code-fundi-repo-blueprint	README más descripción general de dependencias y convenciones (sucesor de repo-readme)
code-fundi-repo-radius	Guardia de Radio de Impacto: cada archivo y función que se rompe antes de fusionar (PRO+)

Archivos

Herramienta	Descripción
code-fundi-list-files	Lista de archivos en un repositorio
code-fundi-file-docs	Obtiene documentación de archivos generada por IA

Historial

Herramienta	Descripción
code-fundi-list-history	Lista el historial de consultas con filtros
code-fundi-history-item	Obtiene los detalles completos de una entrada de historial
code-fundi-conversation	Obtiene los mensajes del hilo de conversación

Estadísticas

Herramienta	Descripción
code-fundi-usage-stats	Desglose de uso por tipo de consulta
code-fundi-activity-stats	Estadísticas diarias de actividad
code-fundi-language-stats	Uso de lenguaje de programación

Autenticación

Herramienta	Descripción
code-fundi-auth-authenticate	Iniciar flujo de autenticación OTP/contraseña (sin clave necesaria)
code-fundi-auth-verify	Verificar código OTP y obtener clave de API
code-fundi-auth-resend	Reenviar correo de verificación OTP
code-fundi-list-api-keys	Listar claves de API (enmascaradas)
code-fundi-regenerate-api-key	Regenerar clave de API
code-fundi-disable-api-key	Deshabilitar una clave de API por ID (DELETE /v2/keys/{key_id})

Chat y modelos

Herramienta	Descripción
code-fundi-chat	Chat de IA Fundi (POST /v1/fundi/chat; las respuestas transmitidas se recopilan como texto)
code-fundi-list-models	Lista el catálogo de modelos de chat seleccionados (GET /v2/models)
code-fundi-model-limits	Obtiene los límites del modelo de IA y la configuración por nivel (GET /v2/models/limits)

Autenticación

Dos modos: clave de API preconfigurada (CODEFUNDI_API_KEY en la configuración MCP) o autenticación OTP/contraseña impulsada por agente en tiempo de ejecución. Las instrucciones completas paso a paso, nombres de herramientas y manejo de errores están en Primeros pasos para agentes de IA al inicio de este README.

Variables de entorno

Variable	Requerida	Predeterminado	Descripción
CODEFUNDI_API_KEY	No*	—	Clave de API para autenticación
CODEFUNDI_BASE_URL	No	https://api.codefundi.app	Anulación de la URL base de la API

* Requerida a menos que se usen herramientas de autenticación impulsadas por agente.

Licencia

MIT