🔧 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 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 - 詳細はLICENSEファイルを参照してください。

👨💻 コントリビューション

このプロジェクトに貢献するには、以下を行ってください：

リポジトリをフォークする
機能用のブランチを作成する (git checkout -b feature/AmazingFeature)
変更をコミットする (git commit -m 'Add some AmazingFeature')
ブランチにプッシュする (git push origin feature/AmazingFeature)
プルリクエストを開く

Renesas FSP MCP Server