ArkTS Helper MCP

ArkTS/ArkUI 开发助手 MCP Server，为 AI 编程助手（Claude Code、Cursor、Windsurf 等）提供文档检索和华为官方智能问答能力。

功能概览

快速开始

安装

git clone https://github.com/LongLiveY96/arkts-helper-mcp.git
cd arkts-helper-mcp
npm install
npm run build

配置 AI 助手

Claude Code / Cursor / Windsurf：

{
  "mcpServers": {
    "arkts-helper": {
      "command": "node",
      "args": ["/path/to/arkts-helper-mcp/dist/index.js"]
    }
  }
}

HTTP 模式（可选）

npm run start:http

端点：

• GET /health — 健康检查
• GET /search?q=关键词 — 搜索文档
• GET /doc/:objectId — 获取文档
• GET /topics — 列出主题

使用示例

配置完成后，AI 助手会自动调用工具：

用户：@State 和 @Prop 有什么区别？
AI：→ find_docs({ query: "State Prop 装饰器" })
    → read_doc({ objectId: "arkts-state" })
    @State 是组件私有状态，@Prop 是单向数据传递...

用户：Navigation 怎么实现页面跳转并传参？
AI：→ ask_ai({ query: "Navigation 页面跳转传参" })
    Navigation 是路由容器组件，通过 NavPathStack 管理页面栈...

用户：同时告诉我 @State、@Prop、@Link 的用法
AI：→ ask_ai_batch({ queries: ["@State用法", "@Prop用法", "@Link用法"] })
    (并行查询，约 60 秒返回全部结果)

环境变量

AI 问答认证（可选）

匿名模式有次数限制。配置登录态 Cookie 可解除限制：

1. 登录 developer.huawei.com
2. F12 → Network → 使用智能问答提问
3. 找到 dialog/submission 请求，复制 Cookie
4. 通过工具设置：set_ai_auth({ cookie: "你的Cookie" })

Cookie 保存在 ~/.config/arkts-mcp/config.json，不会进入代码仓库。

许可证

MIT