@verifiedstate/mcp

Name: verifiedstate-mcp
Author: verifiedstate

Официальный мост MCP для VerifiedState — подключайте Claude Code, Cursor, Windsurf и другие MCP-клиенты к проверенной памяти и Proof Meter.

Этот пакет запускает локальный stdio MCP-сервер, который проксирует вызовы инструментов к размещенному эндпоинту. Ваш API-ключ никогда не покидает вашу машину, за исключением заголовка Authorization: Bearer для VerifiedState.

Размещенный 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`	Расчет по квитанциям в пакет с корнем Меркла.
`meter_verify`	Криптографическая проверка квитанции о расходах.
`meter_receipts`	Список и фильтрация квитанций о расходах для пространства имен.
`session_save`	Сохранение состояния сеанса (сводка, файлы, решения, следующие шаги).
`session_load`	Загрузка последнего сохраненного сеанса для проекта.
`session_end`	Завершение сеанса с необязательной сводкой (сеансы также сохраняются автоматически).

Установка

npm install @verifiedstate/mcp

Или используйте без установки:

npx -y @verifiedstate/mcp

Окружение

Переменная	Обязательно	Описание
`VERIFIEDSTATE_API_KEY`	Да (для `tools/call`)	API-ключ с verifiedstate.ai/keys
`VERIFIEDSTATE_NAMESPACE_ID`	Нет	`namespace_id` по умолчанию, подставляемый в аргументы инструментов, если не указан

Конфигурация MCP

Cursor

Добавьте в свою конфигурацию MCP (например, Cursor Settings → 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

Используйте эквивалентную запись MCP-сервера в конфигурации Windsurf (команда 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 и настройте аутентификацию Bearer с вашим API-ключом. Точная структура 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