GenReady

@genready/mcp-server

将 GenReady 接入你的 AI 助手或编码 Agent。扫描任意网页，检查其是否便于 AI 搜索引擎引用和 AI Agent 使用，然后将修复清单直接交给你的 Agent。

1. 获取 API 密钥

在 genready.ai/api-keys 创建密钥。若要读取整个站点的修复计划，请在创建密钥时启用 Read site data（domain:read）。

2. 连接

远程（推荐，无需安装）

任何支持通过 Streamable HTTP 连接远程 MCP 服务的客户端都可以直接连接：

• URL：https://genready.ai/mcp
• 请求头：Authorization: Bearer gr_live_your_key_here

Claude Code：

claude mcp add --transport http genready https://genready.ai/mcp \
  --header "Authorization: Bearer gr_live_your_key_here"

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "genready": {
      "url": "https://genready.ai/mcp",
      "headers": { "Authorization": "Bearer gr_live_your_key_here" }
    }
  }
}

本地命令（stdio）

对于只能启动本地命令的客户端，例如 Claude Desktop：

{
  "mcpServers": {
    "genready": {
      "command": "npx",
      "args": ["-y", "@genready/mcp-server"],
      "env": { "GENREADY_API_KEY": "gr_live_your_key_here" }
    }
  }
}

此软件包会将请求转发到托管端点，因此两种方式提供的工具相同。

3. 提问

扫描 https://example.com，检查其 AI 就绪度，并在此代码库中修复你能修复的问题。

工具

工具	功能	积分
analyze_website	扫描 URL。返回评分和修复清单。scope：full、content、crawlability。	每次扫描 1 积分
get_report	按 ID 读取已存储的报告，包括其修复清单。	免费
check_status	查看未完成或以 wait: false 启动的扫描进度。	免费
list_reports	查看历史报告，并可按 URL 和状态筛选。	免费
get_findings	获取页面或整个站点的修复列表，其中包含稳定 ID。	免费
verify_findings	修复部署后，根据实时站点重新检查问题（适用于 Pro 和 Agency）。	免费
update_finding	记录问题已修复、待处理或已忽略。	免费
get_artifact	生成可修复问题的 robots.txt、llms.txt 或 JSON-LD 文件。	免费
start_site_analysis	扫描整个站点（需要 site:analyze）。通过 OAuth 最多扫描 25 个页面。	每页 1 积分
get_usage	查看套餐、已使用和剩余积分。	免费
list_domains	查看受监控的域名（需要 domain:read）。	免费
get_fix_plan	获取基于某个域名最新站点分析结果的全站修复优先级列表（需要 domain:read）。	免费

Pro 和 Agency 套餐包含修复清单。其他套餐的报告会显示该清单已锁定。

环境变量（stdio）

变量	必需	说明
GENREADY_API_KEY	是	你的 API 密钥（以 gr_live_ 开头）
GENREADY_MCP_URL	否	托管 MCP 端点（默认值：https://genready.ai/mcp）

链接

• MCP 文档
• REST API 文档

支持与贡献

• 发现了错误或工具描述有误？提交问题。请注明工具名称、你的提问内容和错误文本。
• 有关账户或套餐的问题：genready.ai/support。
• 此代码库是 GenReady 单体代码库中 MCP 服务的已发布副本。提交拉取请求前，请参阅 CONTRIBUTING.md。