Harmonyos MCP Server

🚀 HarmonyOS MCP Server

This is an MCP server for operating HarmonyOS devices, offering a convenient way to interact with HarmonyOS devices.

🚀 Quick Start

📦 Installation

1. Clone this repository.

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

2. Set up the environment.

uv python install 3.13
uv sync

💻 Usage Examples

Basic Usage

You can use Claude Desktop to try out our tool.

You can also use the openai-agents SDK to test this MCP server. Here is an example:

"""
Example: Use the Openai-agents SDK to call the 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="Use tools to operate HarmonyOS devices and complete tasks.",
        mcp_servers=[mcp_server],
    )

    message = "Launch the `settings` app on the phone"
    print(f"Running: {message}")
    result = await Runner.run(starting_agent=agent, input=message)
    print(result.final_output)


async def main():

    # Initialize the server using an asynchronous context manager
    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"View trace: https://platform.openai.com/traces/trace?trace_id={trace_id}\n")
            await run(server)


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