convez.ai
MCP ServerDevOps & InfraestruturaAvançado
huawei-csl

NPU Coding MCP

huawei-csl/npu-coding-mcp

Documentação PTO-ISA, AscendC, CCE e Runtime para otimização de código Ascend

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe documentação técnica de instruções PTO-ISA, operadores AscendC, intrínsecos CCE e API Runtime CANN 9.0.0. Fornece 32 ferramentas para busca, descoberta e otimização de código em processadores Huawei Ascend, com suporte a múltiplos domínios de documentação técnica integrados.

Instalação

$npx convez-ai huawei-csl/npu-coding-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
2
Acompanhando
0
Saúde
37%
Último commit
há 3 meses
Versão
—
Issues abertas
1
Contribuidores
3

Casos de uso

  • Otimizar e gerar código para processadores NPU Huawei Ascend
  • Buscar instruções assembly e intrínsecos C++ em PTO-ISA
  • Consultar guias de desenvolvimento AscendC e CCE para operadores customizados
  • Integrar documentação CANN em agents de geração de código

Veredito

Ferramenta especializada e bem estruturada para desenvolvedores que trabalham com NPUs Huawei. Cobertura técnica profunda de 32 ferramentas distribuídas em 4 domínios de documentação com índices FTS5 otimizados. Curva de aprendizado alta, exigindo familiaridade com ecossistema CANN/Ascend.

README

A tradução para o português deste README ainda está na fila.

npu-coding-mcp

MCP server exposing PTO-ISA tile instruction documentation, the CANN 9.0.0 AscendC operator development guide, the CCE Intrinsic development guide, and the CANN Runtime API reference for code-generation and optimization agents.

Overview

This server provides four documentation domains through a single FastMCP server:

DomainContentTools
PTO-ISA~143 tile instructions (assembly, C++ intrinsics, constraints, examples)14 tools
AscendCCANN 9.0.0 operator development guide — 1,771 sections across 7 chapters (Chinese)6 tools
CCECANN 9.0.0 CCE Intrinsic development guide — 154 sections across 6 chapters (Chinese)6 tools
RuntimeCANN 9.0.0 Runtime API reference — 940 sections across 2 chapters (Chinese)6 tools

Zero-setup for PTO-ISA: When no docs_path is provided, the server auto-clones pto-isa into ~/.cache/pto-isa-mcp/.

Requirements

  • Python >= 3.10
  • git (for auto-clone of pto-isa; optional if passing explicit docs_path)

Installation

cd /home/ebezati/git/workflow/npu-coding-mcp

# Create venv and install
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Build the AscendC and CCE search indexes (one-time)
python -m npu_coding_mcp build-ascendc-index
python -m npu_coding_mcp build-cce-index

# Or from outside the venv:
PYTHONPATH="src:$PYTHONPATH" python3 -m npu_coding_mcp.__main__ build-ascendc-index
PYTHONPATH="src:$PYTHONPATH" python3 -m npu_coding_mcp.__main__ build-cce-index

The AscendC FTS5 index is ~11 MB and lives at data/ascendc_index.db. The CCE index is ~0.5 MB at data/cce_index.db. If either index is missing when the server starts, it's auto-built from the corresponding data/*_docs/ directory.

Usage

Start the server

# Auto-clone pto-isa + load AscendC docs (stdio mode for MCP clients)
python -m npu_coding_mcp serve --stdio

# Explicit pto-isa path + AscendC
python -m npu_coding_mcp serve /path/to/pto-isa/docs --stdio

# HTTP mode
python -m npu_coding_mcp serve --host 0.0.0.0 --port 8080

# Explicit AscendC paths
python -m npu_coding_mcp serve --ascendc-docs data/ascendc_docs --ascendc-index data/ascendc_index.db --stdio

# With CCE docs enabled
python -m npu_coding_mcp serve --cce-docs data/cce_docs --cce-index data/cce_index.db --stdio

Rebuild the indexes

python -m npu_coding_mcp build-ascendc-index
python -m npu_coding_mcp build-cce-index

CLI options

FlagDefaultDescription
docs_path (positional)auto-clonePath to pto-isa/docs/. Auto-clones from gitcode.com if omitted
--cache-dir~/.cache/pto-isa-mcp/Cache directory for auto-cloned pto-isa
--ascendc-docsdata/ascendc_docs/Path to AscendC docs
--ascendc-indexdata/ascendc_index.dbPath to AscendC FTS5 index
--cce-docsdata/cce_docs/Path to CCE docs
--cce-indexdata/cce_index.dbPath to CCE FTS5 index
--host0.0.0.0HTTP bind address
--port8080HTTP port
--stdiooffRun in stdio transport mode
--log-levelINFOLogging level

MCP Tools (32 total)

PTO-ISA — Discovery & search

ToolDescription
list_categories()List all instruction families with counts and member names
list_instructions(category?)List instructions, filtered optionally by category (partial match)
search_instructions(query)Full-text search across names, summaries, categories

PTO-ISA — Per-instruction detail

ToolDescription
get_instruction(name)Full detail: math, assembly, C++ intrinsic, constraints, examples
get_assembly_format(name, level?)Assembly syntax (L1_SSA / L2_DPS / sync)
get_cpp_intrinsic(name)C++ template signature + header path
get_constraints(name, backend?)Constraints, optionally filtered by backend (a2a3/a5/common)
get_examples(name, mode?)Code examples (auto/manual/asm variants)

PTO-ISA — Reference

ToolDescription
get_grammar()PTO-AS BNF grammar, language spec, conventions
get_family_doc(category)Full assembly family document for a category
get_scalar_ops(name?, subcategory?)Scalar arithmetic ops (MLIR arith dialect, 49 ops)
get_control_flow_ops(name?)Control flow ops (MLIR scf dialect, 8 ops)
get_auxiliary_ops(name?)Non-ISA aux ops (alloc, sync, view, pointer)
get_cce_intrinsics(name, backend?)CCE intrinsic calls per backend

AscendC — Documentation

ToolDescription
ascendc_search_docs(query, max_results, language)Full-text FTS5 search across 1,771 sections. language="en" (default) for translation instruction, "zh" for raw Chinese
ascendc_get_section(path, language)Read a section by file path
ascendc_list_chapters()List 7 chapters with descriptions and section counts
ascendc_get_chapter_tree(chapter_path)Section hierarchy for a chapter, with page ranges
ascendc_search_api(api_name)Fast API lookup in 06_API参考/ only (1,561 API sections)
ascendc_get_toc()Complete document table of contents

CCE — Documentation

ToolDescription
cce_search_docs(query, max_results, language)Full-text FTS5 search across 154 sections. language="en" (default) for translation instruction, "zh" for raw Chinese
cce_get_section(path, language)Read a section by file path
cce_list_chapters()List 6 chapters with descriptions and section counts
cce_get_chapter_tree(chapter_path)Section hierarchy for a chapter
cce_search_api(api_name)Fast API lookup in 06_API参考/ only
cce_get_toc()Complete document table of contents

Runtime — Documentation

ToolDescription
runtime_search_docs(query, max_results, language)Full-text FTS5 search across 940 sections. language="en" (default) for translation instruction, "zh" for raw Chinese
runtime_get_section(path, language)Read a section by file path
runtime_list_chapters()List 2 chapters with descriptions and section counts
runtime_get_chapter_tree(chapter_path)Section hierarchy for a chapter
runtime_search_api(api_name)Fast API lookup by function name (e.g., aclrtMalloc)
runtime_get_toc()Complete document table of contents

All tools are read-only and idempotent.

Agent Orientation Resources

The server exposes four MCP resources that agents load automatically:

ResourceContent
npu-coding://guidePTO-ISA + AscendC + CCE + Runtime orientation: all 32 tools, recommended workflow, key concepts
ascendc://guideAscendC-specific guide: chapter overview, language support, search patterns
cce://guideCCE-specific guide: chapter overview, language support, search patterns
runtime://guideRuntime API-specific guide: chapter overview, language support, search patterns

OpenCode Integration

After uv sync --all-groups, add to opencode.json:

{
  "mcp": {
    "npu-coding": {
      "type": "local",
      "command": ["/home/ebezati/git/workflow/npu-coding-mcp/.venv/bin/python", "-m", "npu_coding_mcp.__main__", "serve", "--stdio"],
      "enabled": true
    }
  }
}

Works globally — data dirs auto-detect from the package location, independent of cwd.

Claude Code Integration

After uv sync --all-groups, add to .mcp.json in your project (or ~/.claude.json for all projects):

{
  "mcpServers": {
    "npu-coding": {
      "type": "stdio",
      "command": "/home/ebezati/git/workflow/npu-coding-mcp/.venv/bin/python",
      "args": ["-m", "npu_coding_mcp.__main__", "serve", "--stdio"]
    }
  }
}

Or via CLI:

claude mcp add --transport stdio npu-coding -- \
  /home/ebezati/git/workflow/npu-coding-mcp/.venv/bin/python \
  -m npu_coding_mcp.__main__ serve --stdio

Language support (all doc domains)

All documentation content is in Chinese. Every content-returning tool accepts a language parameter:

ValueBehavior
"en" (default)Prepends translation instruction. LLM translates Chinese to English
"zh"Returns raw Chinese content as-is

Testing

# PTO-ISA tests (requires pto-isa docs)
PTOISA_DOCS_PATH=/path/to/pto-isa/docs pytest tests/ -v

# Or auto-detect sibling directory:
pytest tests/ -v

Project Structure

npu-coding-mcp/
├── pyproject.toml
├── README.md
├── data/
│   ├── cce_mapping.json         # Pre-built CCE intrinsic mapping
│   ├── ptoisa_headers/          # Snapshot of pto-isa headers
│   ├── ascendc_docs/            # AscendC markdown (1,771 sections)
│   ├── ascendc_index.db         # AscendC FTS5 search index (~11 MB)
│   ├── cce_docs/                # CCE markdown (154 sections)
│   └── cce_index.db             # CCE FTS5 search index (~0.5 MB)
├── src/
│   └── npu_coding_mcp/
│       ├── __init__.py
│       ├── __main__.py           # CLI: serve | build-ascendc-index | build-cce-index
│       │   ├── server.py              # FastMCP server + all three stores
│       ├── loader.py              # PTO-ISA doc parser (ISAStore)
│       ├── models.py              # PTO-ISA Pydantic models
│       ├── tools.py               # 14 PTO-ISA tool definitions
│       ├── repo_manager.py        # Auto-clone/pull pto-isa.git
│       ├── ascendc/               # AscendC documentation submodule
│       │   ├── __init__.py
│       │   ├── models.py          # SearchResult, SectionContent, ChapterInfo
│       │   ├── loader.py          # AscendCStore + FTS5 access
│       │   ├── tools.py           # 6 AscendC tool definitions
│       │   └── index_builder.py   # Build FTS5 index
│       └── cce/                    # CCE documentation submodule
│           ├── __init__.py
│           ├── models.py          # SearchResult, SectionContent, ChapterInfo
│           ├── loader.py          # CCEStore + FTS5 access
│           ├── tools.py           # 6 CCE tool definitions
│           └── index_builder.py   # Build FTS5 index
├── scripts/
│   └── build_cce_mapping.py       # CCE mapping build script
├── tests/
│   ├── test_loader.py
│   └── test_cce_extractor.py
└── plan/
    └── TODO.md
Ver o original no GitHub

Bom para

Relacionados