Jev MCP

Jev MCP

J ev の TypeSafe System One モデルを、OpenRouter または TypeSafe から直接利用して、あらゆる MCP クライアントに型付きの確率的な判断を提供する、依存関係の少ない小規模な MCP サーバー です。

Jev はテキストを生成しません。データと型付きの質問を送ると、質問ごとに調整済みの回答を 1 つ返します。選択肢からの選択、はい／いいえの確率、または定義した尺度上の位置を、信頼度と確率分布全体とともに返します。単一の並列処理で高速に回答し、チャットモデルのわずかなコストで利用できます。また、提示していない選択肢を返すことはありません。

このサーバーはこれを 5 つの MCP ツールとして公開し、プロバイダーが返すすべての回答を検証します。認証情報を漏らさず、有料の呼び出しを再試行することもありません。

使用する理由

• 推測ではなく、エージェントに判断させます。 ルーティング、トリアージ、分類、主張の検証、ランキングを、ワークフローで処理したりエスカレーションしたりできる、確率付きの明示的な型付き呼び出しにできます。
• 低コストで高速です。 項目や質問の数にかかわらず、ツールの呼び出しごとに有料の推論呼び出しは 1 回です。
• プロバイダーを選びません。 既存の OpenRouter キー、または TypeSafe キーを使用できます。環境変数 1 つで切り替えられます。
• 出力に忠実です。 回答は質問に照らして検証されます。一貫性のない回答や不完全な回答は、補正されずに呼び出しが失敗します。usage.cost を含むプロバイダーからの応答は常に変更されずに返されます。
• 設計上、安全です。 認証情報はサーバー環境内だけに保管され、HTTPS が必須です。リダイレクトは拒否され、リクエストとレスポンスのサイズおよび所要時間には上限が設けられています。

クイックスタート

1. API キーを取得する

• OpenRouter（デフォルト）：openrouter.ai でキーを作成し、OPENROUTER_API_KEY を設定します。Jev は typesafe/jev-latest として登録されています。jev-latest だけの ID も使用できます。
• TypeSafe：typesafe.ai でキーを作成し、TYPESAFE_API_KEY と JEV_PROVIDER=typesafe を設定します。

2. サーバーをインストールする

次のいずれかを選んでください。

バイナリ。 お使いのプラットフォーム用のアーカイブをリリースからダウンロードします（Linux、macOS、Windows、amd64 および arm64）。checksums.txt と照合して検証し、jev-mcp を PATH に追加します。

コンテナー。 タグ付きの各リリース向けにイメージが公開されています。

docker pull ghcr.io/freepik-company/jev-mcp:latest

Go ツールチェーン。

go install github.com/freepik-company/jev-mcp/cmd/jev-mcp@latest

3. MCP クライアントに登録する

このサーバーは stdio 経由で MCP を使用し、認証情報を環境から読み込みます。キーをツール引数に指定しないでください。

Claude Code

claude mcp add jev -e OPENROUTER_API_KEY="$OPENROUTER_API_KEY" -- jev-mcp

Claude Desktop、Cursor、その他の JSON 設定クライアント

{
  "mcpServers": {
    "jev": {
      "command": "jev-mcp",
      "env": { "OPENROUTER_API_KEY": "sk-or-..." }
    }
  }
}

バイナリの代わりにコンテナーを使用する場合（-i を使い、-t は使わないでください。キーはクライアントの環境から継承されます）。

{
  "mcpServers": {
    "jev": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "OPENROUTER_API_KEY", "ghcr.io/freepik-company/jev-mcp:latest"]
    }
  }
}

TypeSafe を直接使用する場合は、OpenRouter キーの代わりに "JEV_PROVIDER": "typesafe" と TYPESAFE_API_KEY を追加します。

このサーバーは MCP Registry にも io.github.freepik-company/jev-mcp として登録されているため、レジストリを参照できるクライアントからインストールできます。

設定

変数	デフォルト／用途
JEV_PROVIDER	openrouter または typesafe（デフォルト：openrouter）
OPENROUTER_API_KEY	OpenRouter の認証情報
TYPESAFE_API_KEY	TypeSafe の認証情報
API_KEY	選択したプロバイダーの認証情報を上書きします
JEV_MODEL	jev-latest。ツール呼び出しごとに model で上書きできます
BASE_URL	プロバイダーの API ルート。末尾に /v1/systemone が追加されます

デフォルトのルートは https://openrouter.ai/api と https://api.typesafe.ai です。 BASE_URL は HTTPS である必要があります。ローカルプロキシやテスト用途では、ループバック上に限り平文の HTTP も使用できます。認証情報はサーバー環境に設定し、ツールの引数には決して含めないでください。

ツール

ツール	入力	結果
decide	共通の state と名前付きの questions	型付きの未加工の回答とプロバイダーのメタデータ
classify	items、categories、instructions	各項目のカテゴリ、信頼度、確率
verify	claims、evidence	各主張について supported、contradicted、または insufficient_evidence
rerank	query、candidates、省略可能な top_k	0～4 の基準による関連度スコア（降順）
list_models	引数なし	対応するモデル ID と設定済みのデフォルト

項目、主張、証拠、候補は、1～64 件の { "id": "unique-id", "text": "..." } 配列です。カテゴリはカテゴリ ID を説明に対応付けます。3 つのタスクツールは省略可能な model を受け付け、推論を 1 回実行して、results と変更されていないプロバイダーの response（提供されている場合は response.usage.cost を含む）を返します。 分類と検証では入力順を維持し、ランキングでは同点の場合に入力順を維持します。 top_k はすべての候補を評価した後に結果を絞り込みます。入力が切り詰められることはありません。

検証では、指定された証拠のみを使用します。判定はモデルによる判断であり、証明や承認ではありません。自動的な受け入れしきい値は設定されていません。モデルの検出では、推論を行わず、OpenRouter の decisions カタログまたは TypeSafe のネイティブカタログを使用します。

例：decide

{
  "state": {"ticket": "Please refund the duplicate charge."},
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this ticket?",
      "criteria": {"billing": "Payments and refunds", "technical": "Software defects"}
    },
    "refund": {"type": "noul", "instructions": "Is a refund requested?"},
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": ["Routine", "Service blocked", "Active financial harm"]
    }
  }
}

choice は指定された選択肢を選びます。noul は P(true) を返します。score は確率で重み付けした基準インデックスを返します。スコアの凡例や、利用可能な場合の usage.cost を含め、プロバイダーの出力全体が保持されます。

例：classify

{
  "instructions": "Route each support message to the right queue.",
  "categories": {
    "billing": "Charges, invoices and refunds",
    "technical": "Bugs, errors and outages",
    "other": "Anything else"
  },
  "items": [
    {"id": "m1", "text": "I was charged twice this month."},
    {"id": "m2", "text": "The export button does nothing."}
  ]
}

入力順に、各項目について { "id", "category", "confidence", "probabilities" } を 1 件ずつ返し、プロバイダーの response 全体も返します。

制限と障害モード

不明な入力フィールド、不完全な回答、または一貫性のない回答がある場合、呼び出しは失敗します。 リクエストには 30 秒のタイムアウト、1 MiB の入力上限、2 MiB の応答上限があります。 有料の呼び出しは自動的に再試行されません。プロバイダーのエラーでは HTTP ステータスのみが表面化し、応答本文は決して表面化しないため、プロバイダーが認証情報を返してもモデルに渡ることはありません。完全な仕様については、入力スキーマと出力スキーマを参照してください。

開発

必要なのは Docker のみです。

make test       # formatting, vet, race-enabled unit and integration tests
make image      # runtime image, tagged jev-mcp:local
make release    # archives and checksums for every platform in dist/

cmd/jev-mcp にエントリーポイントがあります。internal/ では、設定、System One クライアントと回答の検証、タスクレイヤー、MCP プロトコルを分離しています。 CI では、プッシュとプルリクエストのたびにビルドとテストを検証します。バージョンタグを付けると、リリースアーカイブ、GHCR 上のコンテナイメージ、MCP Registry への登録が公開されます。

ワークフローと設計原則については CONTRIBUTING.md、脆弱性の報告については SECURITY.md、リリースノートについては CHANGELOG.md を参照してください。

ライセンス

Apache License 2.0。Jev と System One は TypeSafe AI の製品です。このプロジェクトは独立したクライアントであり、TypeSafe または OpenRouter とは提携していません。