ArkTS Helper MCP

ArkTS Helper MCP

Provides documentation search, reading, and AI-powered Q\&A for ArkTS/ArkUI development, enabling AI coding assistants to answer questions and retrieve official docs.

Category
Visit Server

README

ArkTS Helper MCP

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

功能概览

工具 功能 说明
find_docs 文档搜索 关键词搜索 1000+ 篇 ArkTS/ArkUI 官方文档
read_doc 文档阅读 根据 objectId 获取完整 Markdown 内容
list_doc_topics 分类浏览 列出所有文档主题及数量
ask_ai AI 问答 调用华为官方智能问答，获取整合回答
ask_ai_batch 批量问答 并行处理多个问题，大幅节省时间
read_more 读取全文 获取被截断的完整回答
set_ai_auth 设置凭证 配置登录态 Cookie，突破匿名次数限制

快速开始

安装

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 秒返回全部结果)

环境变量

变量名 说明 默认值
ARKTS_DOCS_DIR 文档目录路径 static/docs
ARKTS_MCP_PORT HTTP 服务端口 3456
ARKTS_QA_TIMEOUT_MS AI 问答超时（毫秒） 120000
ARKTS_MCP_CONFIG_DIR Cookie 配置目录 ~/.config/arkts-mcp

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured