mcpField
T
Termux-API-Tools-MCP-Server 项目说明

Termux-API-Tools-MCP-Server 项目说明

本地服务
github.com/hyhAsma开发工具1277 周前更新

关于 Termux-API-Tools-MCP-Server 项目说明

Termux-API-Tools-MCP-Server 是通过 Termux-API 让 MCP 客户端操控 Android 设备的练习项目,包含设备信息读取及电话、短信等敏感操作。

主要功能

  1. 01读取部分设备信息
  2. 02读取通话和短信记录
  3. 03拨打电话并发送短信
  4. 04通过 MCP 客户端控制设备

适用场景

  1. 01查看 Android 设备信息
  2. 02查阅通话或短信记录
  3. 03从 MCP 客户端拨打电话或发送短信

MCP 相关

它让 MCP 客户端通过 Termux-API 控制 Android 设备,并要求 Termux 可经局域网访问。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

来自项目 README

Termux-API-Tools-MCP-Server 项目说明

目录

项目概述

本项目是一个基于 Termux-API 的新人练手项目,主要用于通过 MCP 客户端操控 Android 设备。它提供了部分敏感操作功能,包括获取手机信息和执行电话/短信相关操作。

注意:本项目涉及敏感功能,使用时请谨慎,建议敏感信息处理尽量使用本地 LLM。

功能特性

  • 获取手机相关信息(部分功能可能涉及敏感数据)
  • 获取通话记录、获取短信记录等功能(敏感操作)
  • 拨打电话、发送短信等功能(敏感操作)
  • 通过 MCP 客户端进行远程控制

工作逻辑

项目采用以下工作逻辑:

  1. Android 设备(Termux 环境)与 MCP 客户端处于同一局域网;
  2. Termux开启SSHD,并配置远程登陆;
  3. termux-api-tools-mcp-server.py可以链接的到Termux;
  4. 通过MCP客户端 JSON 配置建立连接:
{
    "termux-api-mcp-tools": {
      "name": "termux-api-mcp-tools",
      "type": "stdio",
      "isActive": true,
      "tags": [
        "termux",
        "android",
        "mobile"
      ],
      "command": "python.exe",
      "args": [
        "D:\\test\\termux-api-mcp\\termux-api-tools-mcp-server.py"
      ],
      "env": {
        "TERMUX_SSH_HOST": "192.168.x.xx",
        "TERMUX_SSH_PORT": "xxxx",
        "TERMUX_SSH_USER": "username",
        "TERMUX_SSH_PASSWORD": "password"
      }
    }
}

如何使用

  1. 将上述JSON导入cherry studio或claude等MCP客户端;
  2. 修改其termux-api-tools-mcp-server.py位置为自己本地文件位置
  3. pip install 相关包
  4. 填写env相关信息(前提是termux开启sshd,termux-api-tools-mcp-server.py可以通过网络请求的到termux)

测试截图

README 配图 README 配图 README 配图

已知问题

  • 获取设备上所有无线电模块 (termux-telephony-cellinfo) 有点问题
  • cherry stduio调用电话cell功能存在异常
  • 其他偶发的调用失败情况(可能是手机兼容性问题)
  • 还有几个不常用的API未通过本地测试故没有添加进项目

免责声明

本项目为学习练习用途,开发者对使用本项目可能造成的任何后果不承担责任。涉及敏感操作的功能请谨慎使用,并遵守当地法律法规。

未来计划

  • 完善代码异常处理
  • 增加更多设备控制功能如需更多Android信息可以参考ADB-MCP-Server
  • 提高代码质量和安全性

新人练手项目,请多包涵!联系作者:B站@忘月沁

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。