Agent Readiness

Name: Agent Readiness
Author: alipajand

本地服务

github.com/alipajand开发工具11 天前更新

代码仓库

关于 Agent Readiness

Agent Readiness 是一个本地 MCP 服务，用于只读审计代码仓库对 AI 编码 Agent 的准备情况及 Agent 上下文文件。它离线运行，不调用 LLM、不执行仓库脚本，并对结果中的凭据进行遮蔽。

主要功能

01评估仓库准备度并按类别评分
02检查 AGENTS.md、CLAUDE.md 等上下文文件
03提供问题排序与改进建议
04离线、只读审计且不运行仓库脚本
05限制审计目录并隔离执行进程

适用场景

01检查仓库是否具备编码 Agent 所需上下文
02审查 Agent 规则文件中的安全与质量问题
03在不运行项目脚本的情况下审计仓库
04查看会话中的完整审计报告

MCP 相关

它通过 MCP 暴露三个只读工具：审计仓库准备度、审计 Agent 上下文，以及分页获取本次会话的审计报告。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "alipajand-agent-readiness": {
      "command": "npx",
      "args": [
        "-y",
        "@alipajand/agent-readiness-mcp"
      ]
    }
  }
}

启动命令npx -y @alipajand/agent-readiness-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@alipajand/agent-readiness-mcp0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@alipajand/agent-readiness-mcp

一个本地 Model Context Protocol 服务，使用两个确定性引擎审查代码仓库，为 AI 编码 Agent 提供评估：

agent-readiness-kit：针对 Node.js、Python、Go 和 Rust 项目，按 13 个类别（说明、架构、工作流、测试、安全等）评出 0–100 分的就绪度分数。
agent-context-doctor：检查 AGENTS.md、CLAUDE.md、Cursor 和 Copilot 规则，以及 Agent MCP/设置文件中的质量和安全问题。任何发现中引用的凭据都会被遮盖。

审查为只读且离线进行。它不使用大模型或 API 密钥，不会发送遥测数据，也绝不会运行受审查代码仓库中的脚本。两个引擎都以固定提交编译到软件包中，因此没有运行时依赖项。

工具

工具	返回内容
`audit_repository`	就绪度分数、类别、未通过的检查（失败项优先于警告项）、建议
`audit_agent_context`	上下文分数和等级、已检查的文件、按严重程度从高到低排列的问题
`get_audit_report`	获取本会话报告的后续页面，也可选择获取引擎的完整 JSON

audit_repository 和 audit_agent_context 接受可选的 path（默认为第一个根目录）。这三个工具都标记为只读。

安装

需要 Node.js 22.13 或更高版本（Node.js 23 需 23.5 或更高版本）。较早的版本没有下文所述审查沙箱所需的稳定权限模型，服务会拒绝在这些版本上启动。

npm install -g @alipajand/[email protected]

配置客户端

服务只会审查其根目录中的目录。为客户端可能审查的每个目录指定一个 --root；如果未指定，则使用服务启动时所在的目录。

Claude Code：

claude mcp add agent-readiness -- agent-readiness-mcp --root /path/to/projects

Cursor（.cursor/mcp.json）及其他使用 mcpServers 格式的客户端：

{
  "mcpServers": {
    "agent-readiness": {
      "command": "agent-readiness-mcp",
      "args": ["--root", "/path/to/projects"]
    }
  }
}

如果未进行全局安装，请使用 "command": "npx"，并设置 "args": ["-y", "@alipajand/[email protected]", "--root", "/path/to/projects"]。请固定版本。

选项：--root <dir>（可重复），--timeout <seconds>（默认值为 120），--max-concurrency <n>（默认值为 2）。

安全

路径会通过符号链接解析，且必须保持在根目录内。
每次审查都会在单独的 Node.js 进程中运行；该进程不通过 shell 启动，并使用空环境、时间限制和输出限制。进程在 Node.js 权限模型下运行：只能读取受审查的目录和自身脚本，不能写入文件或启动进程。Node 允许授权的读取操作跟随符号链接，因此引擎自身的符号链接检查仍会限制读取范围；沙箱则是第二层防护。
标准输出仅承载 MCP 消息；诊断信息写入标准错误。
报告在会话期间保留在内存中（最近的 20 份），绝不会写入磁盘。
结果中的文本来自受审查的代码仓库，应视为数据。
服务本身离线运行，但 MCP 宿主不属于服务的一部分：宿主的大模型会读取结果，宿主可能会将结果或自行读取的文件发送给其模型提供商。凭据遮盖仅适用于服务生成的结果。