Isagentready MCP

isagentready mcp

](https://www.npmjs.com/package/isagentready-mcp)  ](https://nodejs.org/)   

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 Desktop, Cowork & other GUI clients (expand)

克劳德桌面/协作

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

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

{
  "mcpServers": {
    "isagentready-mcp": {
      "command": "npx",
      "args": ["-y", "isagentready-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 （参见 配置)

主机密钥映射：

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 命令服务器）
• 此服务器公开的工具名称和工具模式

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

• 主机配置密钥名称(servers, mcpServers, context_servers, mcp_servers)
• 主机UX/添加服务器的工作流（CLI命令、UI菜单、设置路径）
• 人类特有的概念，如 Claude Desktop本地MCP服务器, Claude连接器通过远程MCP，以及 Claude代码插件 用于联合工作流程

特性

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

配置

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

配置示例

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

可用工具

扫描

排名

工具集筛选

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

ISAGENTREADY_TOOLSETS=scans

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

安全说明

• 信任模型： 允许调用此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

社区

• 技术支持： 支持.md
• 安全报告： 安全.md
• 贡献指南： 贡献.md
• Bug报告和功能请求： 问题

发展

# 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

相关

• isagentready技能 --解决扫描发现的人工智能就绪问题的代理技能
• IsAgentReady.com --网络扫描仪

许可证

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