开源地址：https://github.com/DongYin-Fenghua/claude-code-skills-checker

前言

随着 Claude Code 在开发者群体中的普及，越来越多的开发者开始使用 Skills 和 MCP（Model Context Protocol）服务器来扩展 Claude Code 的能力。但你是否遇到过这样的困扰：

• 安装了一堆 Skills，却不知道哪些真正生效了？

• MCP 服务器启动了，但不确定是否真正可用？

• 想查看当前的模型配置和权限设置，却要翻好几个文件？

今天给大家介绍一个我开发的开源小工具——Claude Code Skills Checker，一条命令搞定所有检测。

工具介绍

它能做什么？

这个工具可以一次性扫描并展示 Claude Code 的完整运行环境：

检测项	内容
📦 Skills	所有已安装的 Skill，含中文描述、调用方式、启用状态、文件统计
🔧 MCP 服务器	进程检测 + 服务健康检查，准确判断是否真正可用
⚙️ 模型配置	当前模型、API 地址、推理强度
🔐 权限配置	所有已授权的 Skill/Bash 权限
📊 统计摘要	一键查看整体健康状况

两个版本

• 终端版 check_skills.py：适合习惯命令行的开发者，输出带颜色的表格

• GUI 版 check_skills_gui.py：图形化界面，支持刷新按钮、搜索筛选、颜色状态标识

为什么需要它？

场景一：Skills 状态不透明

Claude Code 的 Skills 系统允许你扩展 AI 的能力边界。但安装后，你可能不确定：

• Skill 是否被正确识别？（SKILL.md 格式是否正确？）

• 是“用户可调用”还是“自动路由”？

• 是否需要在 settings.local.json 中添加权限？

这个工具会逐项检测每个 Skill 的状态，精确定位问题并给出修复建议。

场景二：MCP 服务器检测困难

MCP 服务器是 Claude Code 连接外部工具的桥梁（如 IDA Pro、Kali Linux）。但检测它们是否真正可用并不简单：

• 进程存在 ≠ 服务可用（可能是僵尸进程）

• 配置文件存在 ≠ 服务启动

• 端口监听 ≠ 服务正常响应

本工具采用三层并行检测机制：

text

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  进程检测    │     │  主程序检测  │     │  服务健康检查 │
│  (PowerShell)│     │  (tasklist)  │     │  (HTTP/TCP)  │
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       └───────────────────┼───────────────────┘
                           │
                    ┌──────▼──────┐
                    │  综合判断    │
                    │  ~2秒完成    │
                    └─────────────┘

最终给出准确的状态判断：

状态	含义
✔ 运行中	MCP 进程 + 主程序/服务均正常
⚠ 僵尸进程	进程存在但主程序已退出或服务不可达
✘ 未启动	无进程、无配置

场景三：快速排查问题

当 Claude Code 行为异常时，这个工具可以快速帮你定位：

• Skill 没生效？→ 检查是否缺少 SKILL.md 或权限配置

• MCP 工具调用失败？→ 检查服务是否真正可达

• 权限不足？→ 查看当前授权列表

快速上手

环境要求

• Python 3.10+

• Claude Code 已安装

• Windows 10/11（主要支持）/ Linux / macOS

安装

bash

git clone https://github.com/DongYin-Fenghua/claude-code-skills-checker.git
cd claude-code-skills-checker

无需安装任何第三方依赖，全部使用 Python 标准库。

运行

bash

# 终端版
python check_skills.py

# GUI 版
python check_skills_gui.py

效果展示

终端版输出

text

════════════════════════════════════════════════════════════════
  📦 已安装 Skills 详细检测 (14 个)
════════════════════════════════════════════════════════════════

  🏁 CTF 竞赛 Skills
────────────────────────────────────────────────────────────────
  [ 1] ctf-crypto    ✔ 已启用
       密码学攻击
       全面的密码学攻击技术知识库。覆盖 RSA、AES、ECC、格基约化...
       调用方式: Claude 自动路由  (自动触发)
       文件组成: 17 个知识文件

  [ 2] ctf-web       ✔ 已启用
       Web 应用安全
       Web 漏洞利用全栈技术。覆盖认证与访问控制、服务端攻击...
       调用方式: Claude 自动路由  (自动触发)
       文件组成: 21 个知识文件

════════════════════════════════════════════════════════════════
  🔧 MCP 工具服务器 (2 个)
════════════════════════════════════════════════════════════════
  MCP 服务器    │ 说明                 │ 状态
  ──────────────┼──────────────────────┼──────────
  ida-pro-mcp   │ IDA Pro 逆向工程集成 │ ✔ 运行中
  kali-mcp      │ Kali Linux 安全工具集│ ⚠ 僵尸进程

GUI 版界面

GUI 版本基于 Tkinter，采用深色主题设计：

• 5 个标签页：Skills、MCP 服务器、模型配置、权限配置、统计摘要

• 🔄 刷新按钮：点击实时重新检测

• 搜索 + 筛选：快速定位目标 Skill

• 颜色状态：绿色（正常）、黄色（警告）、红色（异常）

技术亮点

1. 并行检测，速度飞快

MCP 服务器检测采用 concurrent.futures.ThreadPoolExecutor 并行执行三项检查，总耗时仅约 2 秒。

python

with concurrent.futures.ThreadPoolExecutor(max_workers=3) as executor:
    f_procs = executor.submit(check_mcp_processes)   # 进程检测
    f_ida = executor.submit(check_ida_running)        # 主程序检测
    f_kali = executor.submit(check_kali_service)      # 服务健康检查

2. 临时脚本，避免转义问题

Windows 下 PowerShell 内联命令的引号转义是个噩梦。本工具采用写临时 .ps1 脚本文件的方式执行，彻底避免转义问题：

python

with tempfile.NamedTemporaryFile(mode='w', suffix='.ps1', delete=False) as f:
    f.write(ps_script)
    ps_file = f.name
subprocess.run(["powershell.exe", "-File", ps_file])
os.unlink(ps_file)

3. SKILL.md 智能解析

不依赖 pyyaml，自行解析 YAML frontmatter，支持多行值（|、>）、metadata 嵌套字段等格式。

4. 中文显示宽度对齐

终端输出中，中文字符占 2 个显示宽度。本工具实现了 display_width() 和 pad_to_width() 函数，确保中英文混排时表格对齐。

自定义扩展

添加新的 MCP 服务器

在 collect_mcp_servers() 中修改：

python

known_servers = {
    "ida-pro-mcp": "IDA Pro 逆向工程集成",
    "kali-mcp": "Kali Linux 安全工具集",
    "your-mcp": "你的自定义 MCP 服务器",  # 添加在这里
}

添加 Skill 描述

在 SKILL_DESCRIPTIONS 字典中添加：

python

SKILL_DESCRIPTIONS = {
    "your-skill": (
        "简短名称",
        "详细描述此 skill 的功能..."
    ),
}

适用人群

• Claude Code 用户：想了解自己的 Skills 和 MCP 配置状态

• CTF 选手：安装了大量 CTF Skills，需要确认是否全部生效

• 安全研究员：使用 IDA Pro MCP、Kali MCP 等工具，需要快速检测连接状态

• 开发者：调试 Claude Code 扩展时需要环境诊断

项目地址

GitHub: https://github.com/DongYin-Fenghua/claude-code-skills-checker

欢迎 Star ⭐ 和 PR 🎉

总结

这个工具虽然小巧，但在日常使用 Claude Code 的过程中非常实用。它解决了 Skills 和 MCP 服务器“看不见摸不着”的痛点，让你对自己的 AI 编程环境了如指掌。

如果你也在使用 Claude Code，不妨试试这个工具，一键掌握你的完整配置状态。