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())