MCP Serial Port Tool

# MCP串口工具 (MCP Serial Port Tool) 基于MCP（Model Context Protocol）协议的串口工具，为AI助手提供与物理串口设备交互的能力。 ## 功能特性 - 🔄 基于MCP协议的标准化接口 - 🔌 跨平台串口支持（Windows COM / Linux tty） - ⚡ 异步事件驱动架构 - 🔒 写入互斥锁保证数据完整性 - 🎯 配置化URC识别与过滤 - 📊 结构化日志与健康检查 - 🧪 完整的测试覆盖 ## 快速开始 ### 安装依赖 ```bash npm install ``` ### 开发模式 ```bash npm run dev ``` ### 构建项目 ```bash npm run build ``` ### 运行测试 ```bash npm test ``` ## 项目结构 ``` mcp2serial/ ├── src/ # 源代码 │ ├── core/ # 核心引擎层 │ ├── adapters/ # 硬件适配层 │ ├── services/ # 业务服务层 │ ├── mcp/ # MCP协议层 │ ├── utils/ # 工具模块 │ └── types/ # 类型定义 ├── config/ # 配置文件 ├── tests/ # 测试代码 ├── docs/ # 文档 └── examples/ # 示例配置 ``` ## API接口 ### 串口操作 - `serial.open` - 打开串口 - `serial.close` - 关闭串口 - `serial.write` - 写入数据并读取响应 - `serial.list` - 获取可用串口列表 - `serial.status` - 查询串口状态 ### 通知 - `serial.report` - 异步事件通知（URC、错误、状态变化） ### 健康检查 - `health.status` - 获取系统健康状态 - `health.metrics` - 获取性能指标 ### 日志 - `trace.get_log` - 获取日志记录 ## 配置说明 主要配置文件位于 `config/` 目录： - `default.yaml` - 默认配置 - `urc-patterns.yaml` - URC模式配置 详细配置说明请参考 [配置文档](docs/CONFIGURATION.md) ## 开发指南 ### 代码规范 项目使用ESLint和TypeScript严格模式，请确保代码符合规范： ```bash npm run lint npm run lint:fix ``` ### 测试 ```bash # 运行所有测试 npm test # 监视模式 npm run test:watch # 覆盖率报告 npm run test:coverage ``` ## 许可证 MIT License ## 贡献 欢迎提交Issue和Pull Request！