# jev-mcp **Repository Path**: ai_1024/jev-mcp ## Basic Information - **Project Name**: jev-mcp - **Description**: MCP server exposing TypeSafe Jev (System One decision tools) via the OpenCode inference endpoint; zero-config proxy support - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-14 - **Last Updated**: 2026-10-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # jev-mcp 把 [TypeSafe Jev](https://docs.typesafe.ai/)(System One 决策模型)封装成 **MCP 工具**,通过 **OpenCode 推理端点**调用——**不需要 OpenRouter**。 Jev 不生成文本:它对给定上下文回答**类型化问题**,返回**校准概率**(约 150–500ms): - **是/否判断**(`noul`) - **多选一**(`choice`) - **档位评分**(`score`) 适合:告警是否误报、请求紧急度、内容路由、情绪/风险分级等**分类决策**场景。 ## 快速开始(OpenCode) 1. 准备好 OpenCode 的 API key(`OPENCODE_GO_API_KEY` / `OPENCODE_API_KEY`,Go 订阅或 Console key 均可)。 2. 在 `opencode.json`(或 `opencode.jsonc`)中加入: ```jsonc { "mcp": { "jev": { "type": "local", "command": ["npx", "-y", "@wangkh/jev-mcp"], "environment": { "JEV_API_KEY": "{env:OPENCODE_GO_API_KEY}", "JEV_MODEL": "jev-1.13-free" } } } } ``` 3. 重启 OpenCode,让模型调用 `jev_verify` / `jev_score` / `jev_choose` 即可。 本地开发(未发布 npm 前)可直接指向文件: ```jsonc "command": ["node", "D:/work/jev-mcp/bin/jev-mcp.js"] ``` ## 工具 | 工具 | 用途 | 输出 | |---|---|---| | `jev_verify` | 是/否判断 | `probability`(0~1)、`verdict`(yes/no) | | `jev_score` | 档位评分 | `top`(档位+概率)、`probabilities`、`score`、`confidence` | | `jev_choose` | 多选一 | `choice`、`confidence`、`probabilities` | 调用示例(`jev_verify`)返回: ```json { "probability": 0.96, "verdict": "yes", "usage": { "input_tokens": 290, "output_tokens": 23 } } ``` ## 环境变量 | 变量 | 默认 | 说明 | |---|---|---| | `JEV_API_KEY` | — | 优先读取;未设置时回退 `OPENCODE_GO_API_KEY` / `OPENCODE_API_KEY` | | `JEV_MODEL` | `jev-1.13-free` | 模型 ID;可换 `jev-1.13`(付费,需 Console 余额) | | `JEV_PROXY` | 自动检测 | 手动指定代理(如 `http://127.0.0.1:7890`);`none` 禁用自动检测 | | `JEV_BASE_URL` | `https://opencode.ai/inference` | 端点覆盖(测试用) | ## 网络与代理 - **默认自动检测代理**:`HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY`(含小写);Windows 下还会读取**系统代理注册表**——Clash 等"系统代理"模式**零配置即可用** - 目标为 `localhost` / `127.0.0.1` 时永不使用代理(本地开发友好) - 网络抖动(代理瞬时 `ECONNRESET`、5xx、429)**自动重试 2 次**;4xx 直接返回错误 ## 隐私与计费 - 请求直接发往 OpenCode 推理端点;本服务器**不落盘、不记录**任何内容 - `jev-1.13-free` 为限时免费模型;数据策略以 OpenCode / TypeSafe 官方公告为准 ## 开发 ```bash npm test # 离线测试:本地 mock 上游,零网络 ``` 实现为零依赖核心(Node ≥ 20)+ `undici`(仅代理支持用);单文件 MCP stdio 服务器。 ## 发布(维护者) ```bash npm test npm pack --dry-run # 检查打包内容 npm publish --access public # 需要已登录的 npm 账号(@wangkh) ``` ## 已知小坑 - 在 **jev-mcp 仓库自身目录**里用 `npx -y @wangkh/jev-mcp` 启动会失败(npm 会误判为"本地包"去找不存在的本地 shim);换个目录即可,正常使用(含 OpenCode)不受影响。 ## License MIT