MCP 的核心就是把普通函数包装成「工具」供 AI 调用。下面我们挑选几类Zui实用的功Neng来演示。

from mcp.server.fastmcp import FastMCP, Image
from mcp.server.fastmcp.exceptions import ToolError
from pydantic import Field
mcp = FastMCP
@mcp.tool
def get_logcat,
               level: str = Field) -> str:
    """返回Zui近 N 条 Logcat 日志，Yi按包名和等级过滤"""
    ...
# geng多工具紧随其后……

@mcp.tool
def get_screenshot -> Image:
    """抓取当前设备屏幕并返回压缩后的 PNG 数据"""
    try:
        tmp_path = "/sdcard/tmp_screenshot.png"
        local_path = os.path.join
        subprocess.run(, check=True,
                       stdout=subprocess.DEVNULL)
        subprocess.run(, check=True,
                       stdout=subprocess.DEVNULL)
        subprocess.run(, check=True,
                       stdout=subprocess.DEVNULL)
        with PILImage.open as img:
            # 按需压缩，默认 50% 大小，可自行调参
            w, h = img.size
            img_resized = img.resize)
            buf = io.BytesIO
            img_resized.save
            data = buf.getvalue
        os.remove
        return Image
    except Exception as exc:
        raise ToolError

@mcp.tool
def get_ui_dump(attributes: str = Field(
        description="逗号分隔的属性列表，如 'bounds,text,class'")) -> str:
    """调用 uiautomator dump 并仅保留感兴趣属性"""
    try:
        dump_remote = "/sdcard/window_dump.xml"
        dump_local = os.path.join
        subprocess.run(,
                       check=True, stdout=subprocess.DEVNULL)
        subprocess.run(,
                       check=True, stdout=subprocess.DEVNULL)
        subprocess.run(,
                       check=True, stdout=subprocess.DEVNULL)
        tree = ET.parse
        root = tree.getroot
        wanted = {a.strip for a in attributes.split if a.strip}
        for node in root.iter:
            for attr in list:
                if attr not in wanted:
                    del node.attrib
        os.remove
        return ET.tostring
    except Exception as exc:
        raise ToolError

@mcp.tool
def tap_screen,
               y: int = Field) -> str:
    """在指定坐标轻点一次"""
    try:
        subprocess.run(,
                       check=True, stdout=subprocess.DEVNULL)
        return f"Yi在  位置轻点"
    except Exception as exc:
         raise ToolError
@mcp.tool
def swipe_screen -> str:
    """模拟滑动手势，dur 为毫秒，可选"""
    try:
        cmd=f"input swipe {x1} {y1} {x2} {y2} {dur}"
        subprocess.run(,check=True,
                       stdout=subprocess.DEVNULL)
        return f"从  滑到  完成"
    except Exception as exc:
         raise ToolError
@mcp.tool
def send_text) -> str:
    """向当前焦点输入框发送文字，需要注意特殊字符转义"""
    if not text:
         raise ToolError
    safe=text.replace
    try:
         subprocess.run(,
                        check=True,stdout=subprocess.DEVNULL)
         return f'Yi输入文字：“{text}”'
     except Exception as exc:
         raise ToolError
@mcp.tool
def perform_system_action(action:str=Field(
          description='系统按键名称：BACK / HOME / RECENT')) -> str:
     mapping={"BACK":"KEYCODE_BACK","HOME":"KEYCODE_HOME","RECENT":"KEYCODE_APP_SWITCH"}
     key=mapping.get)
     if not key: raise ToolError
     try:
         subprocess.run(,
                        check=True,stdout=subprocess.DEVNULL)
         return f'Yi执行系统操作 {action.upper}'
     except Exception as exc:
         raise ToolError

def start_server:
    os.makedirs
    # 注册所有工具
    print
    if mode=="stdio":
         mcp.run
    elif mode=="streamable-http":
         mcp.run
    elif mode=="sse":
         mcp.run
    else:
         print
if __name__=="__main__":
     from argparse import ArgumentParser
     parser=ArgumentParser
     parser.add_argument('--mode',choices=,
                         required=True,help='传输协议')
     parser.add_argument('--temp-dir',required=True,
                         help='临时文件存放目录')
     parser.add_argument('--port',type=int,default=8080,
                         help='HTTP 模式下使用的端口')
     args=parser.parse_args
     start_server

{
  "mcpServers": {
      "android-stdio": {
          "command": "uv",
          "args": 
      },
      "android-http": {
          "type": "streamable-http",
          "url": "http://127.0.0.1:8080/mcp"
      }
  }
}

npx @modelcontextprotocol/inspector@latest --config mcp_inspector_config.json --server android-stdio
# 浏览器会自动弹出左侧列出所有注册好的工具，右侧填参后点 Run 即可kan到结果。