AI导哈

AI代理准备度扫描服务

一个基于Model Context Protocol (MCP)的服务，用于扫描任何网站的AI代理准备度，并提供详细报告、评分、等级和可操作建议。

  • by BartWaardenburg
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 BartWaardenburg/isagentready-mcp

使用说明

isagentready mcp

A. 模型上下文协议 （MCP）服务器 IsAgentReady API扫描任何网站以了解人工智能代理的准备情况，并获得5个类别的详细报告，包括分数、字母等级和可操作的建议：发现、结构化数据、语义、代理协议和安全。

添加到编辑器

CLI单行程序——最快的入门方法。选择您的工具：

克劳德代码

claude mcp add isagentready-mcp -- npx -y isagentready-mcp

Codex CLI（OpenAI）

codex mcp add isagentready-mcp -- npx -y isagentready-mcp

Gemini CLI（谷歌）

gemini mcp add isagentready-mcp -- npx -y isagentready-mcp

VS代码（副本）

打开命令选项板(Cmd+Shift+P / Ctrl+Shift+P) > MCP: Add Server >选择 命令（stdio）.

或添加到 .vscode/mcp.json 在您的项目目录中：

{
  "servers": {
    "isagentready-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "isagentready-mcp"]
    }
  }
}

光标

添加 .cursor/mcp.json 在您的项目目录中（或 ~/.cursor/mcp.json 全球）：

{
  "mcpServers": {
    "isagentready-mcp": {
      "command": "npx",
      "args": ["-y", "isagentready-mcp"]
    }
  }
}

支持的客户

此MCP服务器可与支持模型上下文协议的任何客户端配合使用，包括：

客户端 安装最简单
克劳德代码 一个衬垫： claude mcp add
Codex 命令行界面 （OpenAI） 单行： codex mcp add
双子星命令行工具 （谷歌） 一句话： gemini mcp add
VS Code （副驾驶） 命令面板： MCP: Add Server
克劳德桌面版 JSON配置文件
光标 JSON配置文件
帆板运动 JSON配置文件
克莱恩 UI设置
泽德 JSON设置文件
Claude Desktop, Cowork & other GUI clients (expand)

克劳德桌面/协作

Cowork在Claude Desktop内部运行，并使用相同的连接MCP服务器和权限。在Claude Desktop中配置一次，服务器就可以在Cowork中使用。

添加到您的Claude Desktop配置文件中：

平台 配置文件
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
窗户 %APPDATA%\Claude\claude_desktop_config.json 
{
  "mcpServers": {
    "isagentready-mcp": {
      "command": "npx",
      "args": ["-y", "isagentready-mcp"]
    }
  }
}

风帆/克莱恩

客户端 配置位置
风帆冲浪 ~/.codeium/windsurf/mcp_config.json
临床 设置>MCP服务器>编辑 
{
  "mcpServers": {
    "isagentready-mcp": {
      "command": "npx",
      "args": ["-y", "isagentready-mcp"]
    }
  }
}

泽德

添加到Zed设置(~/.zed/settings.json 在macOS上， ~/.config/zed/settings.json 在Linux上）：

{
  "context_servers": {
    "isagentready-mcp": {
      "command": "npx",
      "args": ["-y", "isagentready-mcp"]
    }
  }
}

码头工人

docker run -i --rm ghcr.io/bartwaardenburg/isagentready-mcp

通用MCP服务器配置

在任何支持stdio服务器的MCP主机中使用此功能：

  • 命令： npx
  • Args： ["-y", "isagentready-mcp"]
  • 可选环境变量： ISAGENTREADY_CACHE_TTL, ISAGENTREADY_MAX_RETRIES, ISAGENTREADY_TOOLSETS （参见 配置)

主机密钥映射：

主持人 顶级密钥 备注
VS代码 servers 添加 "type": "stdio" 在服务器对象上
克劳德桌面/光标/风帆/克莱恩 mcpServers 相同的命令/args块
Zed context_servers 相同的命令/args块
食品法典委员会CLI（TOML） mcp_servers 使用TOML，如下所示

Codex CLI（TOML配置替代）

如果你喜欢编辑 ~/.codex/config.toml 直接：

[mcp_servers.isagentready-mcp]
command = "npx"
args = ["-y", "isagentready-mcp"]

其他MCP客户端

对于任何兼容MCP的客户端，请使用以下服务器配置：

  • 命令： npx
  • Args： ["-y", "isagentready-mcp"]
  • 不需要环境变量

克劳德生态系统笔记

Claude目前有多个易于混淆的MCP相关概念：

  • 本地MCP服务器（克劳德桌面）： 定义于 claude_desktop_config.json 然后在你的机器上开始(文档).
  • 合作： 重用Claude Desktop中连接的MCP服务器(文档).
  • 连接器： 在Claude中管理远程MCP集成(文档).
  • 协作插件： Claude特定的工作流打包（说明+工具/数据集成）(文档).在Claude中很有用，但不能作为其他代理客户端的通用MCP服务器配置进行移植。

根据供应商文件验证 2026-03-05.

术语

什么是可跨主机移植的：

  • MCP服务器运行时设置(command, args, env)
  • 运输模型(stdio 命令服务器）
  • 此服务器公开的工具名称和工具模式

什么是特定于主机/供应商的（不可移植）：

特性

  • 3个MCP工具 用于扫描、检索结果和浏览排名
  • 不需要API密钥 -公共API，需要零配置
  • 内置缓存 具有可配置的TTL和扫描自动失效功能
  • 重试逻辑 具有指数回退和 Retry-After 标头支持
  • 结构化内容 与人类可读文本一起返回
  • 工具集过滤 仅公开所需的工具类别
  • 可操作的错误消息 具有上下文感知的恢复建议
  • Docker支持 用于集装箱化部署
  • 97个单元测试 跨越7个测试文件

配置

所有配置都可以通过环境变量进行选择：

变量 描述 默认值
ISAGENTREADY_CACHE_TTL 响应缓存生存期（秒）。设置为 0 禁用缓存。 120
ISAGENTREADY_MAX_RETRIES 具有指数回退的速率限制（429）请求的最大重试尝试次数。 3
ISAGENTREADY_BASE_URL API基本URL https://isagentready.com
ISAGENTREADY_TOOLSETS 要启用的工具类别的逗号分隔列表（请参见 工具集筛选). 所有工具集

配置示例

{
  "mcpServers": {
    "isagentready-mcp": {
      "command": "npx",
      "args": ["-y", "isagentready-mcp"],
      "env": {
        "ISAGENTREADY_CACHE_TTL": "300",
        "ISAGENTREADY_MAX_RETRIES": "5"
      }
    }
  }
}

可用工具

扫描

工具 说明
scan_website 触发对网站的新扫描，以检查AI代理的准备情况。如果在过去一小时内扫描，则返回缓存结果。
get_scan_results 获取包含分数、成绩和推荐的域的最新扫描结果。

排名

工具 说明
get_rankings 通过按年级范围、搜索和排序进行过滤，浏览分页的人工智能就绪度排名。

工具集筛选

通过仅启用所需的工具类别来减少上下文窗口的使用。设置 ISAGENTREADY_TOOLSETS 将环境变量转换为逗号分隔的列表：

ISAGENTREADY_TOOLSETS=scans
工具集 包含的工具
scans scan_website, get_scan_results
rankings get_rankings

如果未设置，则启用所有工具集。无效名称将被忽略；如果所有名称都无效，则启用所有工具集作为回退。

安全说明

  • 信任模型： 允许调用此MCP服务器的任何提示或代理都可以触发网站扫描，并通过IsAgentReady API检索结果。
  • 无需凭据： 此服务器使用公共API，因此没有需要保护的机密。但是，扫描请求会显示您正在评估的域。
  • 团队配置治理： 将共享MCP配置保留在版本控制中，并要求检查命令/args/env/toolset过滤的更改。

示例用法

连接后，您可以使用自然语言与IsAgentReady API进行交互：

  • “扫描example.com查看AI代理就绪情况”
  • “检查example.com的扫描结果是否准备就绪”
  • “向我展示顶级AI就绪网站”
  • “搜索排名高的网站”
  • “我的网站与其他网站相比如何？”

扫描+修复工作流程

结合 isagentready技能 全面扫描、修复和重新验证工作流程的代理技能：

> Scan example.com for AI agent readiness

Scan enqueued for example.com
Status: pending

> Check the results for example.com

Domain: example.com
Grade: B (72/100)
Status: completed

Discovery — 15/20 (75%, weight: 30%)
  [PASS] 1.1 robots.txt (5/5)
  [FAIL] 1.2 sitemap.xml (0/5)
    Recommendation: Add a sitemap.xml file...

> Fix the failing checkpoints

社区

发展

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Run tests
pnpm test

# Type check
pnpm typecheck

项目结构

src/
  index.ts              # Entry point (stdio transport)
  server.ts             # MCP server setup, toolset filtering
  client.ts             # IsAgentReady API HTTP client with caching and retry
  cache.ts              # TTL-based in-memory response cache
  types.ts              # TypeScript interfaces
  format.ts             # Output formatting helpers
  tool-result.ts        # Error formatting with recovery suggestions
  update-checker.ts     # NPM update notifications
  tools/
    scans.ts            # scan_website, get_scan_results
    rankings.ts         # get_rankings

需求

  • Node.js>=20

相关

许可证

麻省理工学院——见 许可证 了解详情。

相关 MCP