Zephyr MCP Agent

一个基于Agno框架的模块化Zephyr RTOS开发工作流MCP（Model Context Protocol）Agent。该Agent提供了一套完整的Zephyr项目管理工具，包括项目初始化、固件烧录、测试、版本管理和Git操作等功能。

A modular Zephyr RTOS development workflow MCP (Model Context Protocol) Agent based on the Agno framework. This Agent provides a comprehensive set of tools for Zephyr project management, including project initialization, firmware flashing, testing, version management, and Git operations.

---

🚀 新特性 / New Features

模块化架构 / Modular Architecture

• 模块化设计 - 将大型单体文件拆分为专注的模块，提高可维护性

• 职责分离 - 每个模块负责特定功能，便于团队协作开发

• 易于扩展 - 新增功能只需在相应模块中添加

• Modular Design - Split large monolithic files into focused modules for better maintainability

• Separation of Concerns - Each module handles specific functionality for team collaboration

• Easy to Extend - Add new features by extending corresponding modules

Agno框架集成 / Agno Framework Integration

• Agno API兼容 - 使用Agno v2.3.2的现代Agent框架

• 工具注册优化 - 使用agent.add_tool()方法注册工具

• Telemetry支持 - 与Agno的telemetry标志兼容

• Agno API Compatible - Uses modern Agno v2.3.2 Agent framework

• Optimized Tool Registration - Register tools using agent.add_tool() method

• Telemetry Support - Compatible with Agno’s telemetry flag

OpenTelemetry分布式追踪 / OpenTelemetry Distributed Tracing

• 可配置追踪 - 支持控制台和OTLP导出器

• HTTP请求追踪 - 自动追踪API请求和工具调用

• 优雅降级 - 当OpenTelemetry依赖未安装时自动禁用

• Configurable Tracing - Supports console and OTLP exporters

• HTTP Request Tracing - Automatically traces API requests and tool calls

• Graceful Degradation - Automatically disables when OpenTelemetry dependencies are not installed

多语言支持 / Multi-language Support

• 国际化 - 支持中文和英文界面

• 自动检测 - 根据HTTP请求头自动检测语言

• 动态切换 - 运行时动态切换语言

• Internationalization - Supports Chinese and English interfaces

• Auto-detection - Automatically detects language from HTTP request headers

• Dynamic Switching - Switch languages at runtime

---

📁 项目结构 / Project Structure

zephyr_mcp/
├── main.py                      # 主入口文件 / Main entry point
├── agent_core.py                # Agent核心类 / Agent core class
├── opentelemetry_integration.py # OpenTelemetry集成模块 / OpenTelemetry integration module
├── http_server.py               # HTTP服务器实现 / HTTP server implementation
├── config_manager.py            # 配置管理模块 / Configuration management module
├── language_manager.py          # 语言管理模块 / Language management module
├── config.json                  # 配置文件（自动生成） / Configuration file (auto-generated)
└── src/                         # 源代码目录 / Source code directory
    ├── tools/                   # 工具模块 / Tools module
    └── utils/                   # 工具类 / Utility classes

---

🔧 核心功能 / Core Features

Zephyr操作 / Zephyr Operations

• 项目初始化 - 支持认证的Zephyr项目初始化

• 固件烧录 - 使用各种烧录器烧录固件到目标板

• 测试框架 - 运行Twister测试并返回结构化结果

• 版本管理 - 切换Zephyr版本和管理更新

• Project Initialization - Initialize Zephyr projects with authentication support