Skip to content

Releases: ascript-cn/ascript-mcp

v1.6.2 — First open-source release 🎉

21 Apr 02:12
@ascript-dancer ascript-dancer
v1.6.2
cab0d51

Choose a tag to compare

View all tags
v1.6.2 — First open-source release 🎉 Latest
Latest

v1.6.2 — First open-source release 🎉

中文 | English below

中文

这是 ascript-mcp 的首个开源版本，在 MIT 许可下发布。

这个项目是什么

ascript-mcp 是 AScript 自动化平台的 MCP 服务器。让 Claude Desktop / Cursor / Trae 等 AI 编程工具能直接：

  • 查询 AScript 的 Android / iOS / Windows API 文档
  • 连接真实手机、截图、拿控件树、OCR、找色
  • 把脚本部署到手机上跑，拿运行日志

相比同类方案的差异：

  • iOS 免越狱、免 Apple 开发者证书（基于 WebDriverAgent 的封装）
  • 支持 ESP32 物理 HID 点击硬件（特定 QA 场景）
  • stdio + SSE 双模式，Cursor/Trae/Claude Desktop 都能接

用法

pip install ascript-mcp

Claude Desktop 配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "ascript": {
      "command": "python",
      "args": ["-m", "ascript_mcp.local"]
    }
  }
}

重启 Claude Desktop，就能看到 25 个新工具。

完整配置见 README。

这次发版相比内部版本的变化

  • ✅ 新增 MIT LICENSE
  • ✅ 新增英文 README，方便国际开发者
  • ✅ 新增 CONTRIBUTING.md、issue 模板、PR 模板
  • ✅ 新增 GitHub Actions：CI（三个 Python 版本跑烟囱测试）
  • ✅ 新增 GitHub Actions：push tag 自动发 PyPI（OIDC，免 token）

下一版计划

  • 英文文档深化
  • 提交 MCP 官方 registry
  • 增加更多工程模板和可跑通的 example

贡献者

感谢首批试用并提反馈的 AScript 社区成员。如果你也想参与，CONTRIBUTING.md 是起点。

English

This is the first open-source release of ascript-mcp, shipped under the MIT license.

What this is

ascript-mcp is the MCP server for AScript, a Python automation platform for Android, iOS, and Windows. It lets AI coding tools (Claude Desktop, Cursor, Trae, etc.) directly:

  • Query AScript's Android / iOS / Windows API docs
  • Connect to real physical devices — screenshots, UI tree dumps, OCR, color matching
  • Deploy scripts to a phone, run them, retrieve logs

Differentiators:

  • iOS without jailbreak and without an Apple developer certificate — via a WebDriverAgent-based bridge
  • Supports ESP32-based physical HID hardware for tap simulation (useful against hardened QA targets)
  • stdio + SSE dual mode — works with Cursor, Trae, Claude Desktop, and anything else that speaks MCP

Install

pip install ascript-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ascript": {
      "command": "python",
      "args": ["-m", "ascript_mcp.local"]
    }
  }
}

Restart Claude Desktop — 25 new tools will appear.

Full docs: README_EN.md.

Changes in this release (vs. previous internal builds)

  • ✅ Added MIT LICENSE
  • ✅ Added English README
  • ✅ Added CONTRIBUTING, issue and PR templates
  • ✅ Added CI workflow (smoke tests on Python 3.10 / 3.11 / 3.12)
  • ✅ Added publish workflow (tag push → auto-release to PyPI via OIDC, no tokens)

What's next

  • Deeper English documentation
  • Submission to the official MCP registry
  • More project templates and runnable examples

Links

Full Changelog: https://github.com/ascript-cn/ascript-mcp/commits/v1.6.2

Assets 2
Loading