el-buen-agente-mcp

优秀 Agent | MCP 服务

🇬🇧 English version

公共 MCP 服务，将 “优秀 Agent” 指南（用于构建稳健大模型 Agent 的规范标准）转化为 18 个可执行工具：无需阅读指南，只需提交 Agent 的定义，即可获得结构化评估、正式契约、作为合并门禁的 19 项检查清单，以及可直接使用的最终定义。

详细说明

Agent 的大部分价值不在模型（模型已是商品），而在于设计时所依据的判断标准：它扮演什么角色、绝不能做什么、拥有多大的自主权、基于什么上下文进行推理，以及如何衡量它是否有效。这些判断标准通常存在于指南和文档中，但人们在构建时往往不会重新阅读。本服务将指南转化为可在工作过程中随时查询的内容，作为 Agent 可以调用的工具。

机制刻意保持简单，并带来一个重要结果：服务不会调用任何模型，也不会保存数据。每个工具都会生成一份“简报”（其对应指南章节中的标准、你提交的 Agent 定义，以及严格的输出格式），然后将其返回。执行评估的是使用 MCP 的客户端大模型（你的 Claude Code、你的 Cursor），使用的是各用户自己的凭据。也就是说，判断标准包含在工具文本中，计算则在你这边运行。任何人都不会共享或支付他人的 API 费用，你评估的定义也绝不会离开你的环境（服务只会记录被调用工具的名称，绝不会记录内容）。

适用于两种场景：

• **设计新 Agent：**流程会先询问是否确实需要 Agent（很多时候，一个提示词或工作流就足够了）；如果确实需要，则会逐个章节引导你完成，直到最终检查清单和可直接使用的定义。
• **审计现有 Agent：**从检查清单开始进行诊断，只深入检查未通过的维度，并给出可衡量的结论，甚至可用作 CI 门禁。

评估结果不是认证标章：工具有意采用严格标准（缺少证据也会被视为问题），因为它的作用是在上线前发现缺口，而不是确认一切无误。所有工具也都支持使用 language: "en" 以英语响应，底层判断标准集中在一个有版本管理的 Markdown 文件中，因此改进指南只需编辑一个文件并提交 PR。

公共端点：https://el-buen-agente-mcp-production.up.railway.app/mcp

连接

Claude Code：

claude mcp add --transport http el-buen-agente https://el-buen-agente-mcp-production.up.railway.app/mcp

**Cursor / Claude Desktop / 任意 MCP 客户端：**将 URL 添加为 HTTP 服务（Streamable HTTP，无需身份验证）。

工作流程

服务会自动推荐执行顺序（通过 instructions、每个响应中的下一步提示，以及工具 recomendar_flujo）：

Agente NUEVO:
evaluar_necesidad → revisar_rol_y_frontera → revisar_outputs → evaluar_autonomia
→ revisar_frontera_ejecucion → auditar_contexto → disenar_evaluacion
→ generar_contrato → checklist_nacimiento (GATE) → construir_agente → plan_de_inicio

Agente EXISTENTE:
checklist_nacimiento (diagnóstico) → tools de las secciones con faltas → re-correr checklist

工具

工具	章节	功能
recomendar_flujo	-	根据情况（新建/已有）返回排序后的计划
evaluar_necesidad	§0	是否需要 Agent，还是更简单的方案就够了？检测反模式
revisar_rol_y_frontera	§1	角色是否明确、领域是否有限定、哪些事不做
revisar_outputs	§2	严格的 schema、面向人的摘要、公开的门禁
evaluar_autonomia	§3	副驾驶 / 监督式 / 自主式 + 护栏
revisar_frontera_ejecucion	§4	哪些是建议，哪些是执行（代码中的 status + 门禁）
aplicar_challenger	§5	对完整定义进行红队测试
challenger_decision	§5	针对某个具体决策提出“3 个不该这样做的理由”
auditar_contexto	§6	3 个层面、时效性、治理、反提示词注入
disenar_evaluacion	§7	指标、黄金集、漂移监控
generar_contrato	§8	Agent 的正式契约（确定性）
evaluar_sistema	§9	是否适配现有 Agent 生态系统
plan_exposicion_mcp	§10	哪些内容以工具/资源/提示词的形式公开
checklist_nacimiento	§11	合并门禁：19 项，给出适用/不适用判定
validar_veredicto	-	使用 outputSchema 验证清单判定（用于 CI 的协议级契约）
construir_agente	-	完成整个流程：生成最终定义（markdown / SKILL.md / system prompt）
plan_de_inicio	§12	部署计划：根据证据从副驾驶逐步提升自主性
get_el_buen_agente	-	完整的 Markdown 指南

它还将指南作为资源（完整内容位于 guide://el-buen-agente，也可按章节获取：guide://el-buen-agente/seccion/{0-12}）和提示词公开。

**🇬🇧 English：**每个评估工具都接受 language: "en"，以英语输出（底层指南为西班牙语；使用它的 Agent 会即时翻译评估标准）。

**注册表：**已发布到 MCP 官方注册表，名称为 io.github.apasztetnik/el-buen-agente-mcp。推送 vX.Y.Z 标签后会自动发布版本（使用 OIDC 的 GitHub Action）。

工作原理

每个工具都封装了相应章节的评估标准、Agent 定义和严格的输出格式（包含符合/部分符合/缺失状态及引用证据的评估、最多 5 条按优先级排序的建议、绿/黄/红判定，以及只有作者才能回答的问题）。调用该工具的 Agent 会依据这一框架执行评估：评估标准随工具提供，不受所用大模型影响。

在 CI 中用作门禁

checklist_nacimiento 会在每次评估结束时生成一个包含稳定键名（与语言无关）的 JSON 区块：

{"tool":"checklist_nacimiento","aptos":17,"parciales":2,"faltas":0,"veredicto":"apto","puntos":[{"n":1,"estado":"ok"}]}

这样就可以阻止不符合清单要求的 Agent 合并（指南 §11）。以下是使用 Claude Code 的工作流示例：

claude -p "Conectate a el-buen-agente y corré checklist_nacimiento sobre agents/mi-agente.md. Respondé SOLO con el bloque JSON." \
  | python3 -c "import json,sys; v=json.loads(sys.stdin.read())['veredicto']; exit(0 if v=='apto' else 1)"

开发

npm install
npm start          # http://localhost:3000/mcp

源指南为 el_buen_agente.md，服务会在启动时按章节解析该文件。要修改评估标准，请编辑此文件。

**技术栈：**Node 18+、Express、@modelcontextprotocol/sdk（Streamable HTTP，无状态）。速率限制：每个 IP 每分钟 60 次请求，全局每分钟 600 次请求。

测试：npm test（确定性测试套件 + golden/ 中包含预期判定的测试夹具）。CI 会在每次推送时运行，Railway 只有在检查通过后才会部署。

**隐私：**服务只记录被调用的工具名称和语言，不会记录评估定义的内容。

**版本历史：**请参阅 CHANGELOG.md。

许可证

MIT