@verifiedstate/mcp

Name: verifiedstate-mcp
Author: verifiedstate

**VerifiedState**를 위한 공식 MCP 브리지 — Claude Code, Cursor, Windsurf 및 기타 MCP 클라이언트를 검증된 메모리 및 Proof Meter에 연결합니다.

이 패키지는 도구 호출을 호스팅된 엔드포인트로 프록시하는 로컬 stdio MCP 서버를 실행합니다. 귀하의 API 키는 Authorization: Bearer 헤더로 VerifiedState에 전송되는 경우를 제외하고는 귀하의 컴퓨터를 절대 떠나지 않습니다.

호스팅된 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-rooted) 배치로 정산합니다.
`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 명령 + env):

{
  "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 형태는 제품에 따라 다르므로, 클라이언트 문서에서 “remote 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