🔧 Renesas FSP MCP 서버

📋 개요

FSP(Firmware Support Package) MCP 서버는 Renesas RA MCU 제품군을 위한 소프트웨어 아키텍처인 Renesas Flexible Software Package의 관리 및 문서 검색 인터페이스입니다.

이 서버는 다음과 같은 기능을 제공합니다:

🔍 GitHub 저장소에서 문서 검색
💻 코드 예제 및 API 참조 탐색
📦 종속성 및 버전 관리
🛠️ e² studio를 이용한 개발 워크플로우 지원

✨ 주요 기능

1. 문서 검색 🔍

GitHub 저장소에서 FSP 문서를 검색합니다:

아키텍처 개요
지원되는 소프트웨어 모듈
드라이버 가이드 및 HAL API 참조
RTOS 통합 문서
미들웨어 스택 문서

2. 코드 예제 탐색 💻

다음 기능에 대한 코드 예제를 탐색합니다:

SPI, I2C, UART 주변 장치 드라이버
ADC/DAC 샘플링 예제
보안 부팅 구현
FreeRTOS 통합
DMA 기반 데이터 전송

3. API 참조 조회 📚

API 문서를 조회합니다:

핵심 FSP 라이브러리 (FspLib)
주변 장치 드라이버 (SPI, I2C, UART 등)
RTOS 통합 API
보안 및 암호화 기능

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 엔드포인트를 추가합니다: 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 파일을 참조하십시오.

👨💻 기여하기

이 프로젝트에 기여하려면 다음 단계를 따르십시오:

저장소를 포크(Fork)합니다.
기능 브랜치를 생성합니다 (git checkout -b feature/AmazingFeature).
변경 사항을 커밋합니다 (git commit -m 'Add some AmazingFeature').
브랜치에 푸시합니다 (git push origin feature/AmazingFeature).
Pull Request를 엽니다.

Renesas FSP MCP Server