MCP
Jev MCP 服务
一个 MCP 端点,让你的 Agent 向 Jev 问类型化的问题:是/否概率、从封闭选项里选一个,或者按你定的等级打分。服务由 JEV Hub 运行,使用你自己的 TypeSafe API key,每次请求通过请求头带上。
端点
| URL | https://jevhub.org/api/mcp |
|---|---|
| 传输方式 | Streamable HTTP,JSON 响应,无会话 |
| 认证 | Authorization: Bearer <TYPESAFE_API_KEY> |
| 协议版本 | 2025-06-18、2025-03-26、2024-11-05 |
| 获取 key | console.typesafe.ai/keys |
加到你的客户端
claude mcp add --transport http jev https://jevhub.org/api/mcp \
--header "Authorization: Bearer $TYPESAFE_API_KEY"{
"mcpServers": {
"jev": {
"url": "https://jevhub.org/api/mcp",
"headers": { "Authorization": "Bearer ${env:TYPESAFE_API_KEY}" }
}
}
}[mcp_servers.jev]
url = "https://jevhub.org/api/mcp"
bearer_token_env_var = "TYPESAFE_API_KEY"在启动客户端的 shell 里导出 TYPESAFE_API_KEY。其他支持 Streamable HTTP、能带请求头的 MCP 客户端用法相同。
工具
| 工具 | 问什么 | 返回 |
|---|---|---|
jev_noul | 一个是/否问题 | noul:答案为“是”的概率,0 到 1 |
jev_choice | 从你的选项里选一个(选项名列表,或选项名到描述的映射) | choice、每个选项的概率、confidence |
jev_score | 把 state 放到 2 到 10 个有序等级上,从低到高 | score(可以落在两级之间)、每级概率、confidence |
jev_evaluate | 同一个 state 的多个类型化问题,用官方 questions 映射 | 按你的问题 id 返回全部答案 |
每个工具都接收 state(文本,或 JSON 对象、数组)和可选的 model,默认 jev-latest。一次工具调用就是一次 systemone 请求。
curl -s https://jevhub.org/api/mcp \
-H "content-type: application/json" \
-H "Authorization: Bearer $TYPESAFE_API_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"name":"jev_choice",
"arguments":{
"state":"Agent wants to run: rm -rf ./dist && git push --force origin main",
"question":"How risky is this command for the repository?",
"options":{"allow":"Local, reversible","review":"Changes shared state","block":"Destroys work or history"}
}}}'{
"model": "jev-1.13.0",
"answer": {
"type": "choice",
"choice": "block",
"probabilities": { "allow": 0.01, "review": 0.18, "block": 0.81 },
"confidence": 0.74
},
"usage": { "input_tokens": 212, "output_tokens": 9 }
}结构就是真实的工具返回;上面的数字是示意。用你的 key 运行就能看到真实值。
Agent 什么时候该调用
在 Agent 的指令里写清楚什么时候问。例如:“执行任何删除文件、推送代码或触碰生产环境的命令前,先用 allow / review / block 调用 jev_choice;除非返回 allow 且置信度高于 0.7,否则先问我。”更多决策点见 把 Jev 放进你的 Agent。
密钥处理与限制
- key 从请求头读取,只用于一次对
api.typesafe.ai的调用,然后丢弃。JEV Hub 不保存、不记录 key、state 或答案。 - 用量计入你的 TypeSafe 账户。TypeSafe 的限流照常生效;429 或 529 会作为工具错误返回,提示稍后重试。
- 没有 key 时,服务仍然响应
initialize和tools/list,客户端能正常显示工具;调用工具时会提示怎么加请求头。 - 这是独立社区运行的服务,不是 TypeSafe 产品。官方文档:docs.typesafe.ai。