Axcess

Axcess — 通过 MCP 进行字体排版无障碍评估

一款付费 MCP 服务，可评估自动化扫描器无法发现的字体排版无障碍问题。

每次评估 $0.05 USDC · Base 主网 · x402 小额支付

---

可检测的问题

自动化工具（axe、Lighthouse、WAVE）只能检测出大约 30% 的 WCAG 不合规问题，几乎无法发现需要设计判断的问题。Axcess 可评估：

• 结合字重考量的对比度：字号相同的情况下，细体字比粗体字需要更高的对比度
• 正文、说明文字和标签的最小字号
• 行高是否合适（包括对阅读障碍用户的适用性）
• 行长（字宽）的舒适度：过宽或过窄
• 长时间使用全大写和斜体的情况
• 字间距过大或过小
• 渐变、图像或图案背景上的文字
• 标题层级以及各级标题之间的视觉区分
• 展示字体的缩放和字距调整
• 超越 WCAG 要求的 Bringhurst 和 Lupton 设计工艺规范

---

作为 MCP 客户端连接

Claude.ai（网页端 — Pro / Max / Team / Enterprise）

设置 → 集成 → 添加 MCP 服务

https://axcess-mcp-server.fly.dev/mcp

Claude Desktop / Cursor（通过 mcp-remote）

添加到 claude_desktop_config.json（或 Cursor MCP 设置）：

{
  "mcpServers": {
    "axcess": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://axcess-mcp-server.fly.dev/mcp"
      ]
    }
  }
}

编程方式（AI Agent 和脚本）

使用 @x402/fetch 自动处理支付：

import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: 'eip155:*', client: new ExactEvmScheme(account) }],
});

const response = await fetchWithPayment(
  'https://axcess-mcp-server.fly.dev/mcp',
  {
    method: 'POST',
    headers: {
      'content-type': 'application/json',
      'accept': 'application/json',
      'mcp-protocol-version': '2025-03-26',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'tools/call',
      params: {
        name: 'evaluate_typography',
        arguments: {
          screen_name: 'Hero Section',
          elements: [
            {
              element_type: 'heading',
              heading_level: 1,
              font_size: 48,
              font_weight: 300,
              line_height: 1.1,
              color_hex: '#888888',
              background_color_hex: '#ffffff',
            },
          ],
        },
      },
    }),
  }
);

参阅 src/scripts/test_paid_tool.ts，查看完整可运行示例。

---

定价

工具	价格	状态
list_capabilities	免费	已上线
evaluate_typography	$0.05 USDC	已上线
evaluate_accessibility	$0.10 USDC	即将推出

支付：通过 x402 protocol 使用 Base 主网上的 USDC（eip155:8453）。

---

工具

list_capabilities（免费）

返回可用工具、定价和评估标准类别。无需支付。

evaluate_typography（$0.05）

评估 1–50 个字体排版元素，并返回结构化的无障碍报告。

输入：

{
  screen_name?: string;          // optional label for the report
  elements: Array<{
    element_id?: string;
    element_type: 'heading' | 'body' | 'caption' | 'label' | 'button' | 'display' | 'ui';
    heading_level?: 1 | 2 | 3 | 4 | 5 | 6;
    font_size: number;           // px
    font_weight: number;         // 100–900
    line_height: number;         // multiplier (e.g. 1.5, not px)
    letter_spacing?: number;     // em units
    text_transform?: 'none' | 'uppercase' | 'lowercase' | 'capitalize';
    font_style?: 'normal' | 'italic' | 'oblique';
    content_length?: number;     // character count
    color_hex: string;           // '#rrggbb'
    background_color_hex: string;
    background_type?: 'solid' | 'gradient' | 'image' | 'pattern' | 'video';
    context?: string;            // e.g. 'hero section', 'navigation'
  }>;
}

输出：

{
  screen_name?: string;
  evaluated_at: string;
  element_evaluations: Array<{
    element_id: string;
    element_type: string;
    issues: Array<{
      criterion_id: string;
      criterion: string;
      severity: 'critical' | 'major' | 'minor';
      wcag_reference: string;
      what_scanners_miss: string;
      finding: string;
      recommendation: string;
      passes_wcag_minimum: boolean;
      passes_design_judgment: boolean;
    }>;
    score: number;              // 0–100
    passes: string[];
  }>;
  summary: {
    overall_score: number;
    verdict: 'pass' | 'needs_work' | 'fail';
    total_issues: number;
    by_severity: { critical: number; major: number; minor: number };
  };
  top_issues: Issue[];
}

---

部署到 Fly.io（免费套餐）

要求：flyctl、Base 上的 USDC 钱包、免费的 CDP API 密钥

fly auth login
fly launch --name axcess-mcp-server --no-deploy

# Set secrets (never committed to git)
fly secrets set PAYMENT_ADDRESS=0x...
fly secrets set X402_NETWORK=eip155:8453
fly secrets set CDP_API_KEY_ID=...
fly secrets set CDP_API_KEY_SECRET=...

fly deploy

你的应用将在 https://axcess-mcp-server.fly.dev 上线。

提交到注册平台之前，请更新 smithery.yaml 中的 URL，以及上方的“连接”部分。

本地自行托管

要求：Node.js 18+

git clone <repo>
cd axcess-mcp-server
cp .env.example .env
# Edit .env with your PAYMENT_ADDRESS, CDP keys, and X402_NETWORK
npm install
npm run build
npm start

在测试网上进行本地开发（无需真实支付）：

PAYMENT_ADDRESS=0x... X402_NETWORK=eip155:84532 npm run dev
EVM_PRIVATE_KEY=0x... npm run test:paid

参阅 .env.example，查看所有配置选项。