harmonyos-dev-mcp 0.7.0__tar.gz

harmonyos_dev_mcp-0.7.0/.gitignore

@@ -0,0 +1,57 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+hm_logs/
+
+# Test
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Config
+.env
+*.local
+
+# Misc
+get-pip.py
+
+# AI Tools
+.opencode/

harmonyos_dev_mcp-0.7.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: harmonyos-dev-mcp
+Version: 0.7.0
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=3.0.0
+Requires-Dist: harmonyos-mcp-common
+Requires-Dist: json5>=0.9.14
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: typing-extensions>=4.8.0

harmonyos_dev_mcp-0.7.0/docs/logs_query.md

@@ -0,0 +1,141 @@
+# logs_query
+
+统一日志查询工具，覆盖：
+- 实时日志抓取
+- 历史日志抓取（按时间自动切换）
+- 本地文件分析
+- 过滤、统计、诊断、崩溃信息聚合
+- 可选快照保存
+
+## 参数
+
+### 数据源参数
+
+| 参数 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `device_id` | string | `null` | 设备 ID |
+| `logs` | string[] | `null` | 直接传入日志行，优先级最高 |
+| `input_file` | string | `null` | 单个本地日志文件 |
+| `input_files` | string[] | `null` | 多个本地日志文件 |
+
+优先级：`logs` > `input_file/input_files` > 设备读取。
+
+### 过滤参数
+
+| 参数 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `lines` | int | `100` | 返回最大行数 |
+| `level` | string | `null` | `D/I/W/E/F` |
+| `tag` | string | `null` | 解析后 tag 精确过滤 |
+| `tag_search` | string | `null` | 原始行搜索 tag 关键字 |
+| `keyword` | string | `null` | 原始行关键字 |
+| `domain` | string | `null` | hilog domain |
+| `pid` | int | `null` | 进程 ID |
+| `package_name` | string | `null` | 包名（自动查 PID） |
+
+### 时间参数
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `start_time` | string | `HH:MM:SS` 或 `YYYY-MM-DD HH:MM:SS` |
+| `end_time` | string | 同上 |
+| `seconds` | int | 最近 N 秒 |
+| `time_expr` | string | 自然语言时间表达（例如“最近10分钟”） |
+
+说明：当查询窗口超过实时缓冲覆盖范围时，自动切换历史日志读取。
+
+### 分析与输出参数
+
+| 参数 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `analysis_type` | string | `summary` | `summary/custom` |
+| `custom_regex` | string | `null` | `analysis_type=custom` 时生效 |
+| `save_path` | string | `null` | 结果落盘路径 |
+| `include_diagnostics` | bool | `false` | 返回过滤统计信息 |
+| `include_crash` | bool | `false` | 聚合 crash 信息 |
+
+## 返回结构
+
+外层统一 MCP，业务结果在 `structuredContent`。
+
+成功：
+
+```json
+{
+  "tool": "logs_query",
+  "ok": true,
+  "result": {
+    "device_id": "3QC0124C11000711",
+    "source": "realtime_buffer",
+    "logs": ["03-05 15:41:03.543 ..."],
+    "total_lines": 1,
+    "truncated": false,
+    "filters_applied": {"level": "E"},
+    "analysis_type": "summary",
+    "analysis": {"level_stats": {"E": 1}},
+    "total_entries_analyzed": 1
+  },
+  "error": null
+}
+```
+
+失败：
+
+```json
+{
+  "tool": "logs_query",
+  "ok": false,
+  "result": {
+    "logs": [],
+    "total_lines": 0,
+    "truncated": false
+  },
+  "error": {
+    "code": "APP_NOT_RUNNING",
+    "detail": "app not running or pid not found: com.example.app"
+  }
+}
+```
+
+`error` 仅保留 `code/detail`。
+
+## 典型调用
+
+### 最近错误日志
+
+```json
+{
+  "name": "logs_query",
+  "arguments": {
+    "level": "E",
+    "lines": 300
+  }
+}
+```
+
+### 指定包最近 10 分钟
+
+```json
+{
+  "name": "logs_query",
+  "arguments": {
+    "package_name": "com.example.myapplication",
+    "time_expr": "最近10分钟",
+    "include_diagnostics": true
+  }
+}
+```
+
+### 保存快照
+
+```json
+{
+  "name": "logs_query",
+  "arguments": {
+    "package_name": "com.example.myapplication",
+    "lines": 500,
+    "save_path": "C:/Users/mu/Desktop/hilog_snapshot.txt"
+  }
+}
+```
+

harmonyos_dev_mcp-0.7.0/docs/query_package.md

@@ -0,0 +1,139 @@
+# query_package
+
+统一包查询工具，支持：
+- 列包：`info_type=list`
+- 查能力：`info_type=abilities`
+- 查主入口：`info_type=main_ability`
+- 查权限：`info_type=permissions`
+
+## 参数
+
+| 参数 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `device_id` | string | `null` | 设备 ID，空时自动选第一台在线设备 |
+| `bundle_name` | string | `null` | 应用包名 |
+| `keyword` | string | `null` | 仅在 `list` 模式下生效，用于过滤包名 |
+| `info_type` | string | `list` | `list/abilities/main_ability/permissions` |
+
+规则：
+- 当 `info_type` 为 `abilities/main_ability/permissions` 时，必须传 `bundle_name`。
+- 当传入 `bundle_name` 且 `info_type=list` 时，会自动切到 `abilities`。
+
+## 返回结构
+
+工具外层为 MCP 标准结构，业务数据在 `structuredContent`：
+
+```json
+{
+  "tool": "query_package",
+  "ok": true,
+  "result": {},
+  "error": null,
+  "meta": {}
+}
+```
+
+失败时：
+
+```json
+{
+  "tool": "query_package",
+  "ok": false,
+  "result": {},
+  "error": {
+    "code": "MISSING_BUNDLE_NAME",
+    "detail": "info_type=\"main_ability\" requires bundle_name"
+  },
+  "meta": {}
+}
+```
+
+`error` 仅包含 `code/detail`，不再包含历史字段。
+
+## 结果示例
+
+### 1. `info_type=list`
+
+```json
+{
+  "tool": "query_package",
+  "ok": true,
+  "result": {
+    "device_id": "3QC0124C11000711",
+    "info_type": "list",
+    "packages": ["com.example.myapplication"],
+    "count": 1,
+    "keyword": ""
+  },
+  "error": null
+}
+```
+
+### 2. `info_type=abilities`
+
+```json
+{
+  "tool": "query_package",
+  "ok": true,
+  "result": {
+    "device_id": "3QC0124C11000711",
+    "info_type": "abilities",
+    "bundle_name": "com.example.myapplication",
+    "abilities": [
+      {"name": "EntryAbility", "module": "entry", "type": "page"}
+    ],
+    "modules": ["entry"],
+    "main_ability": {"name": "EntryAbility", "module": "entry", "type": "page"},
+    "ability_count": 1
+  },
+  "error": null
+}
+```
+
+### 3. `info_type=main_ability`
+
+```json
+{
+  "tool": "query_package",
+  "ok": true,
+  "result": {
+    "device_id": "3QC0124C11000711",
+    "info_type": "main_ability",
+    "bundle_name": "com.example.myapplication",
+    "ability_name": "EntryAbility",
+    "module_name": "entry",
+    "candidates": [
+      {
+        "ability_name": "EntryAbility",
+        "module_name": "entry",
+        "is_entry_module": true,
+        "is_entry_main_ability": true,
+        "is_launcher": true,
+        "source": "entryModule.mainAbility, action.system.home",
+        "visible": true,
+        "type": "page"
+      }
+    ],
+    "recommended": 0
+  },
+  "error": null
+}
+```
+
+### 4. `info_type=permissions`
+
+```json
+{
+  "tool": "query_package",
+  "ok": true,
+  "result": {
+    "device_id": "3QC0124C11000711",
+    "info_type": "permissions",
+    "bundle_name": "com.example.myapplication",
+    "requested_permissions": ["ohos.permission.INTERNET"],
+    "permission_count": 1
+  },
+  "error": null
+}
+```
+

harmonyos_dev_mcp-0.7.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "harmonyos-dev-mcp"
+version = "0.7.0"
+requires-python = ">=3.10"
+dependencies = [
+    "harmonyos-mcp-common",
+    "fastmcp>=3.0.0",
+    "requests>=2.31.0",
+    "json5>=0.9.14",
+    "psutil>=5.9.0",
+    "loguru>=0.7.0",
+    "typing-extensions>=4.8.0",
+]
+
+[project.scripts]
+harmonyos-dev-mcp = "harmonyos_mcp:main"
+
+[tool.uv.sources]
+harmonyos-mcp-common = { workspace = true }
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/harmonyos_mcp"]

harmonyos_dev_mcp-0.7.0/src/harmonyos_mcp/__init__.py

@@ -0,0 +1,27 @@
+"""
+HarmonyOS MCP Server
+
+AI-assisted HarmonyOS development tools via Model Context Protocol.
+"""
+
+__version__ = "0.7.0"
+__author__ = "HarmonyOS MCP Team"
+
+from .server import mcp, main
+from .container import container, get_hdc, get_ui_operations, get_hilogtool, get_hvigor
+from .config import Config, LogSecurityConfig
+from common.exceptions import MCPError
+
+__all__ = [
+    "mcp",
+    "main",
+    "__version__",
+    "container",
+    "get_hdc",
+    "get_ui_operations",
+    "get_hilogtool",
+    "get_hvigor",
+    "Config",
+    "LogSecurityConfig",
+    "MCPError",
+]

harmonyos_dev_mcp-0.7.0/src/harmonyos_mcp/__main__.py

@@ -0,0 +1,9 @@
+"""
+Entry point for running as a module: python -m harmonyos_mcp
+"""
+
+from .server import main
+
+if __name__ == "__main__":
+    main()
+