System One Connector — 给 Coding Agent 接入的判断型 MCP 连接器

技能简介

System One Connector 是 itsmostafa 出品的开源 MCP 连接器，让 Claude Code、Claude Desktop、Codex、Pi、Hermes 等任意编程 Agent 都能调用 TypeSafe 的 Jev 模型，用概率回答「这是不是紧急工单？」「这条评论属于哪个分类？」这类结构化判断问题。它不绑定单一供应商——同一连接器也能跑自托管的 CLM、Laya，或 Liquid AI 托管的 d1 模型。MIT 协议，Go 语言实现，macOS / Linux 双平台一键安装。

核心能力

• evaluate MCP 工具：在 Claude Code / Desktop / Codex / Pi / Hermes 中注册 evaluate，Agent 一行调用即可返回概率结果
• 多模型后端：支持 TypeSafe Jev、本地 CLM（huggingface Contrastive-LM/CLM-v0.1-8B）、Laya 自托管、Liquid AI d1 托管、OpenRouter 转发
• 概率化输出：返回的不是文字段落而是「是 / 否 / 选项 + 概率」，Agent 能直接进 if 分支
• 自动写注册：一条 evaluate setup mcp 命令自动检测本地所有 Agent 客户端并写入配置
• Profile 切换：把多组 Jev / CLM / d1 配置保存成 profile，一条命令切换
• 密钥安全：API Key 走 OS 凭据库 + 隐藏交互输入，不会进入 shell 历史

安装配置

• 系统需求：macOS 或 Linux（Windows 需自行编译）
• 一键安装：curl -fsSL https://raw.githubusercontent.com/itsmostafa/system-one-connector/main/install.sh | sh
• 配置密钥：在 https://console.typesafe.ai/ 申请 API Key，设为环境变量 TYPESAFE_API_KEY
• 注册 Agent：TYPESAFE_API_KEY=xxx evaluate setup mcp，自动写入 Claude Code / Claude Desktop / Codex / Hermes 配置
• Pi 用户：evaluate setup pi 一键注册
• 自托管模型：把 TYPESAFE_BASE_URL 指向本地服务，留任意非空字符串作为 key

使用步骤

1. 在终端执行 install.sh 安装二进制
2. 在 TypeSafe 控制台申请 API Key
3. 设置 TYPESAFE_API_KEY 环境变量
4. 执行 evaluate setup mcp，自动写入所有 Agent 的 MCP 配置
5. 重启 Agent，工具列表中会出现 evaluate
6. 在 Agent 对话中说「用 evaluate 判断这条工单是否紧急、属于哪个团队」
7. Agent 调用 evaluate，返回结构化概率结果，自动进入下游逻辑

适用场景

• Coding Agent 自动判定 PR 是否需要人工 review、阻塞程度
• 客服 Agent 自动判定用户工单紧急度并路由到对应团队
• 内容审核 Agent 自动判定评论是否违规、属于哪个分类
• 多 Agent 协作中的「仲裁者」：当子 Agent 输出冲突时给一个量化裁决
• 安全场景：自动判定某段提示词是否包含 prompt injection

适用人群

• 资深开发者：让 Claude Code 自动判断 PR / Issue 优先级
• 多 Agent 系统架构师：需要一个轻量级「判断模型」做仲裁
• 客服 / 工单系统开发者：用概率化判定替代正则匹配
• 安全研究员：用 Jev 做 prompt injection 检测

工作原理

System One Connector 在 Agent 客户端注册一个 evaluate MCP 工具，背后转发到 TypeSafe 的 Jev 等判断型模型。Jev 的训练目标不是文字生成而是「给问题 + 候选答案 → 返回每个答案的概率」，响应是固定 JSON 结构（如 {"is_urgent":0.95,"department":{"billing":0.86}}），Agent 不需要解析自然语言就能直接消费这些概率。连接器本身用 Go 写成二进制，单文件部署。

官方链接

• GitHub 仓库：https://github.com/itsmostafa/system-one-connector
• TypeSafe 控制台：https://console.typesafe.ai/
• 配置文档：https://github.com/itsmostafa/system-one-connector/blob/main/docs/configuration.md
• Release：https://github.com/itsmostafa/system-one-connector/releases/latest