@verifiedstate/mcp

Name: verifiedstate-mcp
Author: verifiedstate

VerifiedState 的官方 MCP 桥接器 —— 将 Claude Code、Cursor、Windsurf 及其他 MCP 客户端连接到验证内存和 Proof Meter。

此包运行一个本地 stdio MCP 服务器，将工具调用代理到托管端点。除了作为 Authorization: Bearer 发送给 VerifiedState 外，您的 API 密钥绝不会离开您的机器。

托管 MCP 服务器

项目	值
MCP URL	`https://mcp.verifiedstate.ai/mcp`
发现 (Agent Card)	`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 命令 + 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 格式取决于产品；请参阅您客户端关于“远程 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