@verifiedstate/mcp

Name: verifiedstate-mcp
Author: verifiedstate

VerifiedState の公式MCPブリッジ — Claude Code、Cursor、Windsurf、その他のMCPクライアントを検証済みメモリおよびProof Meterに接続します。

このパッケージは、ツール呼び出しをホストされたエンドポイントにプロキシするローカルstdio MCPサーバーを実行します。APIキーは、VerifiedStateへの Authorization: Bearer として以外、マシンから外部へ送信されることはありません。

ホスト型MCPサーバー

項目	値
MCP URL	`https://mcp.verifiedstate.ai/mcp`
ディスカバリー (エージェントカード)	`https://mcp.verifiedstate.ai/.well-known/agent-card.json`
ダッシュボード & キー	verifiedstate.ai · APIキー

リモートHTTP MCPをサポートするクライアントは、上記のURLを直接指定して以下を送信できます：

Authorization: Bearer vs_live_...

ツール (13)

ツール	説明
`memory_ingest`	コンテンツを検証済みメモリに取り込みます。`artifact_id` を返します。
`memory_query`	検証済みメモリに対するセマンティック検索。ランク付けされた主張とレシートを返します。
`memory_verify`	主張の検証を実行し、署名付きレシートを生成します。
`memory_health`	名前空間の健全性：カウント、検証比率、期限切れ/古いデータ、競合などを確認します。
`meter_authorize`	支出予算を設定したProof Meter機能を作成します。
`meter_spend`	機能に対する支出を記録し、ハッシュチェーンされたレシートを返します。
`meter_budget`	機能の残予算と支出の概要を確認します。
`meter_settle`	レシートをMerkleルート化されたバッチに決済します。
`meter_verify`	支出レシートを暗号学的に検証します。
`meter_receipts`	名前空間の支出レシートを一覧表示およびフィルタリングします。
`session_save`	セッション状態（概要、ファイル、決定事項、次のステップ）を永続化します。
`session_load`	プロジェクトの最後に保存されたセッションを読み込みます。
`session_end`	セッションを終了し、オプションで概要を保存します（セッションは自動的にも永続化されます）。

インストール

npm install @verifiedstate/mcp

またはインストールせずに使用する場合：

npx -y @verifiedstate/mcp

環境変数

変数	必須	説明
`VERIFIEDSTATE_API_KEY`	はい ( `tools/call` 用)	verifiedstate.ai/keys から取得したAPIキー
`VERIFIEDSTATE_NAMESPACE_ID`	いいえ	ツール引数で省略された場合に注入されるデフォルトの `namespace_id`

MCP設定

Cursor

MCP設定（例：Cursor設定 → MCP）に追加し、プレースホルダーキーを置き換えてください：

{
  "mcpServers": {
    "verifiedstate": {
      "command": "npx",
      "args": ["-y", "@verifiedstate/mcp"],
      "env": {
        "VERIFIEDSTATE_API_KEY": "vs_live_YOUR_KEY_HERE",
        "VERIFIEDSTATE_NAMESPACE_ID": "optional-default-namespace-uuid"
      }
    }
  }
}

Claude Code

Cursorと同じ形式です。Claude CodeのMCP設定にマージしてください：

{
  "mcpServers": {
    "verifiedstate": {
      "command": "npx",
      "args": ["-y", "@verifiedstate/mcp"],
      "env": {
        "VERIFIEDSTATE_API_KEY": "vs_live_YOUR_KEY_HERE"
      }
    }
  }
}

Windsurf

Windsurfの設定で同等のMCPサーバーエントリを使用してください（stdioコマンド + 環境変数）：

{
  "mcpServers": {
    "verifiedstate": {
      "command": "npx",
      "args": ["-y", "@verifiedstate/mcp"],
      "env": {
        "VERIFIEDSTATE_API_KEY": "vs_live_YOUR_KEY_HERE"
      }
    }
  }
}

リモートHTTP (クライアントがサポートしている場合)

クライアントで https://mcp.verifiedstate.ai/mcp を指定し、APIキーを使用して Bearer 認証を設定してください。正確なJSON形式は製品によって異なります。クライアントのドキュメントで「リモートMCP」または「SSE/HTTP MCP」を参照してください。

プログラムによる設定ヘルパー

import { getConfig } from '@verifiedstate/mcp';

const config = getConfig('vs_live_...', 'optional-namespace-id');
// => { mcpServers: { verifiedstate: { command, args, env } } }

ライセンス

MIT — LICENSE を参照してください。

貢献

CONTRIBUTING.md を参照してください。

verifiedstate-mcp