A11y

🚀 A11y MCP 服務器

A11y MCP 服務器是一個藉助 axe - core 開展網頁可訪問性審核的 Model Context Protocol (MCP) 服務器。它能與您鍾愛的 AI 助手（如 Cline、Cursor、GH Copilot）搭配使用，助力 AI 為您修復可訪問性問題！

🚀 快速開始

A11y MCP 服務器可對網頁進行可訪問性審核，並與 AI 助手結合修復問題。配置完成後，就能讓 AI 助手利用它開展工作啦。

✨ 主要特性

• 能對任意網頁開展詳盡的可訪問性審核。
• 可獲取網頁可訪問性問題的摘要。
• 能夠按照特定的 WCAG 標準對審核結果進行過濾。
• 可在結果裡包含 HTML 片段，便於調試。

📦 安裝指南

全局安裝

npm install -g a11y-mcp

直接使用 npx

npx a11y-mcp

📚 詳細文檔

配置

若要讓此 MCP 服務器與 Cline 協同工作，需將其添加到您的 MCP 設置配置文件中。

MCP 配置

在 mcpServers 對象中添加如下內容：

{
  "mcpServers": {
    "a11y": {
      "command": "npx",
      "args": ["a11y-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

audit_webpage

對網頁執行詳細可訪問性審核。

參數：

• url（必需）：要審核的網頁 URL
• includeHtml（可選）：是否包含 HTML 片段在結果中（默認：false）
• tags（可選）：要檢查的具體可訪問性標籤數組（例如，wcag2a、wcag2aa、wcag21a、best - practice）

示例：

使用 a11y MCP 服務器審核 example.com 的可訪問性問題

get_summary

獲取網頁的可訪問性問題摘要。

參數：

• url（必需）：要審核的網頁 URL

示例：

給我 example.com 的可訪問性問題摘要

示例用法

配置完成後，您可以指示 Claude 使用 MCP 服務器執行可訪問性審核：

1. "你能檢查 example.com 是否存在可訪問性問題嗎？"
2. "審核我的網站 https://mywebsite.com 以符合 WCAG 2.1 AA 標準"
3. "給我 https://example.com 的可訪問性問題摘要"
4. "檢查我本地開發服務器 http://localhost:3000 是否存在任何關鍵的可訪問性問題"

開發

若要在本地運行服務器進行開發，可執行以下命令：

npm start

發佈

該項目包含一個發佈腳本，用於幫助版本控制和發佈到 npm。腳本處理版本遞增、運行測試、創建 Git 標籤以及發佈到 npm。

發佈新版本

# 確保腳本是可執行的
chmod +x release.sh

# 發佈補丁版本（默認）
./release.sh

# 發佈小版本
./release.sh --minor

# 發佈主要版本
./release.sh --major

# 發佈特定版本
./release.sh --version=1.2.3

# 跳過 Git 操作
./release.sh --skip-git

# 幹運行（不做任何更改）
./release.sh --dry-run

# 強制發佈，即使有未提交的更改
./release.sh --force

獲取更多信息

./release.sh --help

📄 許可證

MPL 2.0

致謝

該項目基於傑出的作品 [axe - core](https://github.com/dequelabs/axe - core) 構建。