Jev MCP server
jev-mcp 是把 Jev 决策原语 —— classify、score、check、gate、decide —— 暴露为任何 MCP 客户端(Claude Code、Cursor、Codex、OpenCode)都能调用的工具的开源 MCP server。它用 npx 直接从 GitHub 运行,并从你的 key 选出正确的 endpoint。
每个示例都需要一个 jv_live_ key。在 pricing 页领一个,导出为 JEV_API_KEY,就可以开始了。 获取 key →
如果你到这个页面是因为某次 Jev MCP 配置返回了鉴权错误,修复几乎总是在 endpoint —— 见下面的坑。如果你是全新配置,它只有两行。
安装
在 Claude Code 里最快的路径:
claude mcp add jev -e TYPESAFE_API_KEY=your_key -- npx -y github:codaaiteam/jev-mcp或把它加进任何 MCP 客户端的配置(Cursor、Codex、OpenCode,或你自己的):
{
"mcpServers": {
"jev": {
"command": "npx",
"args": ["-y", "github:codaaiteam/jev-mcp"],
"env": { "TYPESAFE_API_KEY": "jv_live_..." }
}
}
}五个工具
- jev_classify —— 挑选你的某个带标签选项(路由、归类、意图)
- jev_score —— 在你定义的有序刻度上给输入打分(风险、紧急度、质量)
- jev_check —— 一个校准的是/否概率(闸门、过滤、护栏)
- jev_gate —— 在操作运行前做风险筛查 → allow / confirm / block
- jev_decide —— 全功能:一次往返里问许多类型化问题
环境变量
只有 key 是必需的 —— endpoint 会自动从它选出:
TYPESAFE_API_KEY Your Jev key (aliases: JEV_API_KEY, JEV_KEY). Required.
JEV_BASE_URL auto — chosen from your key:
jv_live_… key → https://jevtypesafeai.com/api/v1/decide
other key → https://api.typesafe.ai/v1/systemone
Set explicitly to route through your own gateway.
JEV_MODEL jev-latest (pin e.g. jev-1.13.0 in production)坑:托管的 jv_live_ key 只在网关处有效
一个托管的 jv_live_… key 只在 jevtypesafeai.com 网关处有效,在 api.typesafe.ai 无效。当前版本的 jev-mcp 会检测 jv_live_ key 并自动路由到那里,所以你不用碰 JEV_BASE_URL。如果你用的是旧版本、且托管 key 返回了 401 authentication_error,请升级 —— 或显式设 JEV_BASE_URL=https://jevtypesafeai.com/api/v1/decide。官方 TypeSafe key(来自 console.typesafe.ai)默认用 api.typesafe.ai。
改走你自己的网关
显式设 JEV_BASE_URL,把调用改走你自己的网关 —— Vercel AI Gateway、OpenRouter 或 Cloudflare。其余一切不变。
常见问题
为什么我的 Jev MCP key 返回 401 authentication_error?
几乎总是 endpoint 的问题。一个托管的 jv_live_ key 只在 jevtypesafeai.com 网关处有效,在 api.typesafe.ai 无效。升级 jev-mcp(它会自动识别 jv_live_ key),或显式设 JEV_BASE_URL=https://jevtypesafeai.com/api/v1/decide。
jev-mcp 需要什么 key?
TYPESAFE_API_KEY(别名 JEV_API_KEY、JEV_KEY)。用来自 jevtypesafeai.com/pricing 的托管 jv_live_ key,或来自 console.typesafe.ai 的官方 key。
我需要设 JEV_BASE_URL 吗?
正常使用下不需要。jev-mcp 会从你的 key 选 endpoint —— jv_live_ key 走托管网关,官方 key 走 api.typesafe.ai。只有在你想强制走自己的网关时才设它。
jev-mcp 支持哪些 MCP 客户端?
任何 MCP 客户端 —— Claude Code、Cursor、Codex、OpenCode 等等。只是配置文件位置不同;命令和环境变量都一样。
我怎么固定模型版本?
设 JEV_MODEL,例如 JEV_MODEL=jev-1.13.0,让生产环境停在一个固定版本,而不是 jev-latest。
另见:Cursor 集成 · Claude Code 集成 · jev-mcp 与开源 · jev-mcp & open source