tteop-mcp

tteop-mcp

TTEOP — Token Telemetry Evaluation Operator Protocol の本番環境向け MCP サーバーです。

Model Context Protocol を介して、TTEOP テレメトリーエンベロープを構築、検証、説明します。公式の MCP TypeScript SDK v2 と tteop-spec リファレンス実装を利用しています。

初めての方は、START-HERE.md をお読みください。自動化されたコントリビューターも、AGENTS.md をお読みください。

アーキテクチャ

このパッケージは薄い MCP トランスポート層です。すべてのプロトコルロジック（エンベロープの構築、メトリクスの計算（バンカー丸め）、スキーマ検証、セマンティックルール）は、安定した JavaScript API を介して tteop-spec に委譲されます。

• tteop-spec/builder → buildEnvelope(telemetry, options)
• tteop-spec/validator → validateEnvelope(envelope, options)、computeMetrics(telemetry)

ここではメトリクスの計算式やスキーマロジックを重複して実装していません。tteop-spec がバリデーターまたはビルダーを更新すると、このサーバーにもその変更が反映されます。

製品の分離

パッケージ	役割
tteop-spec	仕様、スキーマ、バリデーター、適合性テストスイート、ビルダー API
tteop-mcp	本番環境向け MCP サーバー（このパッケージ）— tteop-spec 上の薄いトランスポート層
SignalAF / SigRank	ホスト型ベンチマーク、リーダーボード、パイロット、エンタープライズサービス

インストール

npm install -g tteop-mcp
# or use directly:
npx tteop-mcp

ツール

ツール	説明
tteop_build_envelope	トークン数から TTEOP v0.1-draft スキーマに準拠したエンベロープを構築します。Yield（Υ）、Leverage（L）、Velocity（V）、output_fraction（F）、log_leverage（D）を計算します。
tteop_validate_envelope	JSON Schema とセマンティックルールに照らしてエンベロープを検証します。スキーマエラー、セマンティックエラー、警告、計算されたメトリクスを返します。
tteop_describe_protocol	TTEOP プロトコルのメタデータ（バージョン、プライバシーモード、出所レベル、禁止フィールド、計算式付きメトリクス定義）を取得します。
tteop_run_conformance	適合性テストスイートを実行します。標準ベクトルの不変条件、null のセマンティクス、禁止フィールドの検出、バンカー丸めを確認します。

使用方法

Claude Desktop で使用する

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "tteop": {
      "command": "npx",
      "args": ["-y", "tteop-mcp"]
    }
  }
}

MCP Inspector で使用する

npx @modelcontextprotocol/inspector npx -y tteop-mcp

ブラウザーのタブを開き、Connect をクリックして、Tools タブを開き、任意のツールを呼び出します。

プログラムから使用する

import { spawn } from "node:child_process";

const proc = spawn("npx", ["-y", "tteop-mcp"], { stdio: ["pipe", "pipe", "pipe"] });
// Send JSON-RPC 2.0 messages to proc.stdin, read responses from proc.stdout

開発

# Install the exact locked dependency graph
npm ci

# Optional: test unpublished local tteop-spec changes after the clean install.
# This overrides node_modules locally and is never used by CI or releases.
cd ../otep-spec && npm link && cd ../tteop-mcp && npm link tteop-spec

# Run tests
npm test                    # real MCP client test
npm run test:packaged       # packaged tarball test
npm run test:release        # package/lockfile/registry version agreement
npm run test:all            # complete local release gate

# Run with MCP Inspector
npm run inspect

# Start the server
npm start

受け入れ基準

• npx tteop-mcp が MCP 接続を待機する
• initialize が成功する
• tools/list が完全なスキーマ（4 つのツール）を返す
• すべてのツールを MCP Inspector 経由で呼び出せる
• 無効なトークン値に対して、構造化された MCP エラー（isError: true と検証メッセージ）が返る
• stdout にプロトコルメッセージのみが出力される
• CI がパッケージ化された tarball に対して実際の MCP クライアントを実行する

配布状況とリリース順序

[email protected] は現在 npm に公開され、MCP Registry と Glama に掲載されています。リリース 0.2.1 では、ソースとパッケージの出所情報を修正し、プロトコル依存関係を正確に [email protected] にアップグレードして、リリースの堅牢性を強化します。

必須のリリース順序は次のとおりです。

1. [email protected] が npm から利用できることを確認します。
2. 必須のチェックがすべて成功した状態で、[email protected] のリリースコミットをマージします。
3. 手動の Release npm package ワークフローを実行します。npm provenance 付きで公開し、同じコミットに GitHub リリース v0.2.1 を作成します。
4. npm view [email protected] gitHead が GitHub リリースのコミットと一致することを確認します。
5. 対応する server.json を MCP Registry に公開します。

   mcp-publisher login
   mcp-publisher publish
   

6. MCP Registry と Glama にバージョン 0.2.1 と 4 つすべてのツールが表示されることを確認します。
7. クリーンなディレクトリから npx -y [email protected] --version と実際の MCP クライアント呼び出しを実行します。

コミットされていない作業ツリーから公開してはいけません。パッケージのバージョン、ロックファイル、server.json、Git タグ、GitHub リリース、npm の gitHead、MCP Registry のバージョンは、すべて同じリリースを示している必要があります。

ライセンス

Apache-2.0