🔧 Renesas FSP MCP 服务器

📋 概述

FSP (Firmware Support Package) MCP 服务器是用于 Renesas Flexible Software Package（瑞萨 RA MCU 系列的软件架构）的管理和文档搜索接口。

该服务器提供以下功能：

🔍 从 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 文件。

👨💻 贡献

要为本项目做出贡献，请：

Fork 本仓库
创建您的功能分支 (git checkout -b feature/AmazingFeature)
提交您的更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启一个 Pull Request

Renesas FSP MCP Server