🔧 Servidor MCP de Renesas FSP

📋 Descripción general

El servidor MCP de FSP (Firmware Support Package) es una interfaz de gestión y búsqueda de documentación para el Renesas Flexible Software Package, la arquitectura de software para la familia de MCU RA de Renesas.

Este servidor proporciona las siguientes capacidades:

🔍 Búsqueda de documentación desde el repositorio de GitHub
💻 Descubrimiento de ejemplos de código y referencias de API
📦 Gestión de dependencias y versiones
🛠️ Soporte para el flujo de trabajo de desarrollo con e² studio

✨ Características principales

1. Búsqueda de documentación 🔍

Busque documentación de FSP desde el repositorio de GitHub:

Descripción general de la arquitectura
Módulos de software compatibles
Guías de controladores y referencias de API HAL
Documentación de integración de RTOS
Documentación de la pila de middleware

2. Descubrimiento de ejemplos de código 💻

Descubra ejemplos de código para funciones como:

Controladores de periféricos SPI, I2C, UART
Ejemplos de muestreo ADC/DAC
Implementación de arranque seguro (Secure boot)
Integración con FreeRTOS
Transferencia de datos basada en DMA

3. Consulta de referencia de API 📚

Consulte la documentación de la API:

Biblioteca principal de FSP (FspLib)
Controladores de periféricos (SPI, I2C, UART, etc.)
API de integración de RTOS
Funciones de seguridad y criptografía

4. Gestión de dependencias 📦

Gestione dependencias y versiones:

Seguimiento del historial de versiones
Matriz de compatibilidad de plataformas
Requisitos de versión de e² studio
Especificaciones mínimas de hardware

🏗️ Arquitectura del sistema

┌─────────────────────────────────────┐
│         MCP Server                  │
│  ┌──────────┬──────────┬──────────┐ │
│  │ Doc      │ Examples │ API      │ │
│  │ Search   │ Discovery│ Reference│ │
│  └──────────┴──────────┴──────────┘ │
│         ↓                           │
│  ┌─────────────────────────────┐    │
│  │  GitHub Repository          │    │
│  │  - Documentation            │    │
│  │  - Code Examples            │    │
│  │  - API References           │    │
│  └─────────────────────────────┘    │
└─────────────────────────────────────┘

📁 Estructura del proyecto

fsp-mcp-server/
├── src/                    # Source code
│   ├── index.ts           # Main MCP server entry point
│   └── handlers/          # Handler modules
│       ├── info.ts        # FSP architecture information
│       ├── version.ts     # Version management
│       ├── documentation.ts  # Documentation search
│       ├── examples.ts    # Code examples discovery
│       ├── api-reference.ts  # API reference lookup
│       └── dependencies.ts   # Dependency management
├── schemas/               # JSON schema definitions
├── docs/                  # Generated documentation
├── examples/              # Usage examples
├── package.json          # NPM configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

🚀 Instalación y uso

1. Instalar dependencias

cd fsp-mcp-server
npm install

2. Compilar y ejecutar

# Build TypeScript code
npm run build

# Run server
npm start

O ejecute directamente en modo de desarrollo:

npm run dev

3. Conectar al cliente MCP

Añada la siguiente configuración a su cliente MCP (por ejemplo, LM Studio, Claude Desktop, etc.):

{
  "mcpServers": {
    "fsp-mcp-server": {
      "command": "node",
      "args": ["/path/to/fsp-mcp-server/dist/index.js"]
    }
  }
}

Reemplace /path/to/fsp-mcp-server con la ruta absoluta real a su directorio de proyecto.

Para LM Studio:

Abra Settings → Extensions → Model Context Protocol.
Añada un nuevo MCP endpoint con el comando: node /path/to/fsp-mcp-server/dist/index.js.
Establezca el transport en stdio.
Guarde y pruebe la conexión a través de MCP Explorer.

🔧 Configuración

Puede personalizar el servidor a través de package.json:

{
  "scripts": {
    "build": "tsc && echo '✅ TypeScript compilation complete: dist/index.js'",
    "build:clean": "npm run build && find dist -name '*.d.ts' -delete && echo '🧹 Cleaned .d.ts files'",
    "dev": "tsx watch src/index.ts",
    "start": "node ./dist/index.js",
    "lint": "eslint \"src/**/*.ts\"",
    "format": "prettier --write ."
  }
}

📚 Referencias

📄 Licencia

Licencia BSD de 3 cláusulas - Consulte el archivo LICENSE para obtener más detalles.

👨💻 Contribución

Para contribuir a este proyecto, por favor:

Haga un fork del repositorio
Cree una rama con su funcionalidad (git checkout -b feature/AmazingFeature)
Confirme sus cambios (git commit -m 'Add some AmazingFeature')
Envíe los cambios a la rama (git push origin feature/AmazingFeature)
Abra una Pull Request

Renesas FSP MCP Server