Harmonyos MCP Server

🚀 HarmonyOS MCP 服務器

這是一個用於操作 HarmonyOS 設備的 MCP 服務器，藉助它可以方便地對 HarmonyOS 設備進行相關操作。

🚀 快速開始

📦 安裝指南

1. 克隆此倉庫

git clone https://github.com/XixianLiang/HarmonyOS-mcp-server.git
cd HarmonyOS-mcp-server

2. 設置環境

uv python install 3.13
uv sync

💻 使用示例

基礎用法

你可以使用 Claude Desktop 來嘗試我們的工具。

高級用法

你也可以使用 openai-agents SDK 來嘗試此 MCP 服務器。以下是一個示例：

"""
示例：使用 Openai-agents SDK 調用 HarmonyOS-mcp-server
"""
import asyncio
import os

from agents import Agent, Runner, gen_trace_id, trace
from agents.mcp import MCPServerStdio, MCPServer

async def run(mcp_server: MCPServer):
    agent = Agent(
        name="Assistant",
        instructions="使用工具來操作 HarmonyOS 設備並完成任務。",
        mcp_servers=[mcp_server],
    )

    message = "在手機上啟動 `settings` 應用"
    print(f"運行：{message}")
    result = await Runner.run(starting_agent=agent, input=message)
    print(result.final_output)


async def main():

    # 使用異步上下文管理器初始化服務器
    async with MCPServerStdio(
        params={
            "command": "<...>/bin/uv",
            "args": [
                "--directory",
                "<...>/harmonyos-mcp-server",
                "run",
                "server.py"
            ]
        }
    ) as server:
        trace_id = gen_trace_id()
        with trace(workflow_name="MCP HarmonyOS", trace_id=trace_id):
            print(f"查看跟蹤：https://platform.openai.com/traces/trace?trace_id={trace_id}\n")
            await run(server)


if __name__ == "__main__":
    asyncio.run(main())