🔧 Renesas FSP MCP Server

📋 Обзор

FSP (Firmware Support Package) MCP Server — это интерфейс для управления и поиска документации по Renesas Flexible Software Package — программной архитектуре для семейства микроконтроллеров Renesas RA.

Этот сервер предоставляет следующие возможности:

🔍 Поиск документации в репозитории GitHub
💻 Поиск примеров кода и справочников API
📦 Управление зависимостями и версиями
🛠️ Поддержка рабочего процесса разработки с e² studio

✨ Основные возможности

1. Поиск документации 🔍

Поиск документации FSP в репозитории GitHub:

Обзор архитектуры
Поддерживаемые программные модули
Руководства по драйверам и справочники HAL API
Документация по интеграции RTOS
Документация по стеку промежуточного ПО (Middleware)

2. Поиск примеров кода 💻

Поиск примеров кода для различных функций:

Драйверы периферии SPI, I2C, UART
Примеры дискретизации ADC/DAC
Реализация безопасной загрузки (Secure boot)
Интеграция FreeRTOS
Передача данных на основе DMA

3. Справочник API 📚

Поиск документации по API:

Основная библиотека FSP (FspLib)
Драйверы периферии (SPI, I2C, UART и т.д.)
API интеграции RTOS
Функции безопасности и криптографии

4. Управление зависимостями 📦

Управление зависимостями и версиями:

Отслеживание истории версий
Матрица совместимости платформ
Требования к версии e² studio
Минимальные аппаратные требования

🏗️ Архитектура системы

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

📁 Структура проекта

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

🚀 Установка и использование

1. Установка зависимостей

cd fsp-mcp-server
npm install

2. Сборка и запуск

# Build TypeScript code
npm run build

# Run server
npm start

Или запустите напрямую в режиме разработки:

npm run dev

3. Подключение к MCP-клиенту

Добавьте следующую конфигурацию в ваш MCP-клиент (например, LM Studio, Claude Desktop и т.д.):

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

Замените /path/to/fsp-mcp-server на фактический абсолютный путь к директории вашего проекта.

Для LM Studio:

Откройте Settings → Extensions → Model Context Protocol.
Добавьте новый MCP endpoint с командой: node /path/to/fsp-mcp-server/dist/index.js.
Установите transport в значение stdio.
Сохраните и протестируйте соединение через MCP Explorer.

🔧 Конфигурация

Вы можете настроить сервер через 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 ."
  }
}

📚 Ссылки

📄 Лицензия

Лицензия BSD 3-Clause — подробности см. в файле LICENSE.

👨💻 Вклад в проект

Чтобы внести свой вклад в этот проект, пожалуйста:

Сделайте форк репозитория
Создайте ветку для вашей функции (git checkout -b feature/AmazingFeature)
Зафиксируйте изменения (git commit -m 'Add some AmazingFeature')
Отправьте изменения в ветку (git push origin feature/AmazingFeature)
Откройте Pull Request

Renesas FSP MCP Server