MCP

Jev MCP 服务

一个 MCP 端点,让你的 Agent 向 Jev 问类型化的问题:是/否概率、从封闭选项里选一个,或者按你定的等级打分。服务由 JEV Hub 运行,使用你自己的 TypeSafe API key,每次请求通过请求头带上。

端点

URLhttps://jevhub.org/api/mcp
传输方式Streamable HTTP,JSON 响应,无会话
认证Authorization: Bearer <TYPESAFE_API_KEY>
协议版本2025-06-18、2025-03-26、2024-11-05
获取 keyconsole.typesafe.ai/keys

加到你的客户端

Claude Code
claude mcp add --transport http jev https://jevhub.org/api/mcp \
  --header "Authorization: Bearer $TYPESAFE_API_KEY"
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "jev": {
      "url": "https://jevhub.org/api/mcp",
      "headers": { "Authorization": "Bearer ${env:TYPESAFE_API_KEY}" }
    }
  }
}
Codex · ~/.codex/config.toml
[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"}
        }}}'
工具返回(structuredContent)
{
  "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。