aethi mcp
Aethis决策引擎的MCP服务器。将立法、政策、合同和法规汇编成确定性逻辑——每次都有相同的输入、相同的答案,并有完整的审计跟踪。
](https://www.npmjs.com/package/aethis-mcp)  
安装 · 技能 · 快速开始 · 工具 · 设置 · 创作 · 数字用户线路 · 故障排除
______________________________________________________________________
安装
创作处于私人测试阶段。 决策工具(aethis_decide,aethis_schema,aethis_explain,aethis_next_question)是公共的,不需要密钥。编写工具(规则生成、测试细化、发布)需要邀请。请求访问 aethis.ai/developer-access.
推荐--一个命令通过 以太气候:
uv tool install aethis-cli
aethis mcp install --target all将服务器连接到claude代码、光标、claude桌面或风帆。Idempotent。重新启动编辑器以获取更改。重新运行后 aethis account generate 旋转一个键。完整选项: aethis mcp install --help.
手动安装:
claude mcp add aethis -- npx -y aethis-mcp有关Cursor/Claude Desktop/Windsurf手动配置,请参阅 设置.
端到端地安装AI编码代理?看 docs.aethis.ai/agents/入职培训 --在一个页面中安装+验证+认证+工作流模式。
______________________________________________________________________
技能
安装MCP服务器后,使用添加可重用的代理工作流 aethis-skills:
npx skills add Aethis-ai/aethis-skills技能包为策略到规则集的编写、测试/优化/发布循环、带跟踪的决策和回归比较提供了工作流。它调用此包中的MCP工具;它不会取代MCP服务器。
______________________________________________________________________
快速开始
aethis_decide({
ruleset_id: "aethis/spacecraft-crew-certification",
field_values: { species: "Vogon" },
include_trace: true
}){
"decision": "not_eligible",
"fields_provided": 1,
"fields_evaluated": 11,
"trace": {
"species_check": "FAIL — species is 'Vogon' (disqualifying, Section 3)"
}
}公共规则集在没有密钥的情况下工作。浏览: aethis_discover_rulesets({}) 或 埃塞俄比亚医生.
发动机确定性+精度基准: Aethis ai/自信错误的基准.
______________________________________________________________________
工具
五组共25个工具。
| 组 | 访问 | 工具 |
|---|---|---|
| 决定 | 公众 | aethis_decide, aethis_schema, aethis_next_question, aethis_explain, aethis_explain_failure |
| 发现——公共目录 | 公众 | aethis_discover_rulesets |
| Discovery--您的租户 | 私人测试版 | aethis_list_projects, aethis_list_rulesets |
| 创作——章节和字段 | 私人测试版 | aethis_discover_sections, aethis_refine_sections, aethis_validate_sections, aethis_set_field_spec, aethis_discover_fields, aethis_refine_fields, aethis_validate_fields |
| 创作——世代 | 私人测试版 | aethis_create_ruleset, aethis_add_guidance, aethis_list_guidance, aethis_generate_and_test, aethis_refine, aethis_publish, aethis_add_domain_guidance, aethis_list_domain_guidance |
| 管理 | 私人测试版 | aethis_archive_project, aethis_archive_ruleset |
工作流
评估资格(2个电话):
aethis_schema(ruleset_id) → fields needed
aethis_decide(ruleset_id, fields) → eligible / not_eligible / undetermined通过 include_trace: true 用于按标准评估试验。通过 include_explanation: true 用于人类可读的规则描述。
对话资格(下一个问题路由):
aethis_next_question(ruleset_id, field_values)返回信息量最大的剩余问题和 optimal_path 剩下的问题。每次应答后再次呼叫;发动机根据更新的状态重新计算。当可以做出决定时停止。
创作 (私人测试版):请参阅 创作.
提示
| 提示 | 描述 |
|---|---|
aethis-author | TDD创作工作流程 |
aethis-decide | 决策工作流程指南;接受可选 ruleset_id |
______________________________________________________________________
设置
决策工具无需密钥即可工作。添加 AETHIS_API_KEY 用于创作访问(私人测试版)。
克劳德代码
# Decision tools only
claude mcp add aethis -- npx -y aethis-mcp
# With authoring access
claude mcp add aethis -e AETHIS_API_KEY= -- npx -y aethis-mcp克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"aethis": {
"command": "npx",
"args": ["-y", "aethis-mcp"]
}
}
}对于创作,请添加 "env": { "AETHIS_API_KEY": "" }.
光标/风帆
添加 .cursor/mcp.json 或 .windsurf/mcp.json (相同的JSON格式)。
钥匙
AETHIS_API_KEY(ak_live_...)——A这个平台密钥。 在MCP客户端配置中设置,而不是你的shell——MCP服务器不继承shell环境。薄荷aethis login或通过仪表板。ANTHROPIC_API_KEY--根据请求转发给aethis_generate_and_test。每次通话使用,从不存储。- 通过以下方式旋转
aethis account generate+aethis account revoke.每台机器铸造一把钥匙,用于手术撤销。
______________________________________________________________________
创作(私人测试版)
创作需要邀请。 请求访问权限决策工具(如上)是公开的。
三阶段工作流程。阶段1-2适用于多段域;跳过单节规则,直接进入第3阶段。
第一阶段——分段发现
aethis_discover_sections({ domain, sources: [{ name, content }, ...] })
aethis_validate_sections({ domain, expected_sections, discovered_sections })
aethis_refine_sections({ domain, feedback, sources })第2阶段——现场词汇
aethis_set_field_spec({
project_id,
expected_fields: [{ key, sort, enum_values? }, ...]
})
aethis_discover_fields({ project_id }) // auto-validates against the spec if set
aethis_refine_fields({ project_id, feedback })
aethis_validate_fields({ project_id, expected_fields })第3阶段——生成、测试、发布
aethis_create_ruleset({
name, section_id, domain?, source_text,
test_cases: [{ name, field_values, expected_outcome }, ...]
})
aethis_generate_and_test({ project_id })
aethis_refine({ project_id, feedback }) // iterate until tests pass
aethis_publish({ project_id }) // refuses if tests fail; returns ruleset_id on success指导
无需重新生成的有针对性的提示,以及领域的横截面原则:
aethis_add_guidance({ project_id, guidance_text, process_type })
aethis_list_guidance({ project_id })
aethis_add_domain_guidance({ domain, guidance_text, process_type, notes? })
aethis_list_domain_guidance({ domain })process_type 是 rule_generation (默认)或 field_extraction.
诊断失败的测试
aethis_explain_failure({
ruleset_id, field_values, expected_outcome, test_name
})
// Returns criterion statuses, the failing rule, and a targeted fix hint.\[!重要\] 测试是发布的大门。 aethis_publish 拒绝发布测试失败的规则集。中小企业编写测试;LLM根据源文本+指南生成规则;该平台拒绝发布不符合测试要求的规则。更好的测试=更快的收敛。\[!重要\] 创作需要人物钥匙。作为anthropic_key上aethis_generate_and_test和aethis_refine。按请求使用,从不存储。
\[!重要\] DATE字段使用整数序号(date.toordinal()),而不是ISO字符串。2025-04-13=739354.快速转换:python3 -c "from datetime import date; print(date(2025,4,13).toordinal())".
______________________________________________________________________
DSL capabilities
字段类型
| 类型 | 描述 |
|---|---|
Bool | 正确/错误 |
Int | 整数(计数,货币为便士,百分比为整数) |
Enum | 封闭的命名值集 |
Date | 整数序号-- date.toordinal() |
Duration | 整数天数 |
String | 自由文本--首选 Enum 对于已知集合 |
运算符
| 类别 | 操作员 |
|---|---|
| 逻辑 | AND, OR, NOT, IMPLIES |
| 比较 | =, ≠, `, ≥` |
| 会员资格 | IN [v1, v2, ...] |
| 算术 | +, − 为了 Int/Date; * 为了 Int |
| 聚合 | min(...), max(...) |
助手
days_between(date_a, date_b)→Intmin(a, b, ...),max(a, b, ...)→Int- 在编写时折叠常量算法(
5 * 365→1825)
不支持
- 运行时字段值之间的划分
- 加权评分或概率结果
- 以字段值形式列出(使用预聚合
Int/Bool) - 超过3个结果层次(
eligible/not_eligible/undetermined)
______________________________________________________________________
故障排除
| 错误 | 原因 | 修复 |
|---|---|---|
API key is required | AETHIS_API_KEY 未设置(编写) | 在MCP客户端设置中配置,而不是在shell配置文件中配置 |
X-Anthropic-Key header is required | 缺少人像钥匙 | 通行证 anthropic_key 关于工具调用 |
Ruleset not found (404) | ID错误或已存档 | aethis_list_projects → aethis_list_rulesets |
Rate limit exceeded (429) | 每日限制 | 客户端自动重试。 eng@aethis.ai 对于更高级别 |
Cannot publish: tests failing | 测试未通过 | aethis_refine 直到所有测试通过 |
| 生成超时(504) | 服务器仍在生成(正常5-15分钟) | 请稍候,然后 aethis_list_rulesets({ project_id }) 检查。不要再次触发 |
Expected an integer for , got str | DATE字段作为ISO字符串传递 | 使用 date.toordinal() 整数 |
______________________________________________________________________
相关
- 以太气候 --Python命令行界面;使用YAML测试用例进行基于文件的创作
- 以太的例子 --可运行的规则集(航天器、建筑CAR、消费信贷)和基准场景
- 自信错误的基准 --论文,225场景基准,LegalBench工具
发展
git clone https://github.com/Aethis-ai/aethis-mcp.git
cd aethis-mcp && npm install && npm test && npm run build许可证
麻省理工学院
