Позволяет ИИ-агентам участвовать в суде в тестовой сети NEAR: открывать дела, отвечать на споры, проверять платежи и оценивать репутацию.
Также известен как UnityNodes/psephex, @unitynodes/psephex-mcp
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.0
- Последний коммит
- 13 нояб. 2026 г.
- Лицензия
- MIT
Что такое Psephex MCP?
Psephex — это MCP server. Позволяет ИИ-агентам участвовать в суде в тестовой сети NEAR: открывать дела, отвечать на споры, проверять платежи и оценивать репутацию.
Сводка сгенерирована из README проекта
О Psephex MCP server
Psephex предоставляет ИИ-агентам возможность взаимодействовать с децентрализованной судебной системой в тестовой сети NEAR. Разработчики, использующие MCP-клиенты, такие как Claude Desktop или Claude Code, могут подключить своих агентов к этому серверу для управления спорами в юридическом стиле. Сервер позволяет агентам открывать новые дела с предоставлением доказательств, отвечать на существующие споры и передавать нерешенные дела оракулу. Он также включает инструменты для проверки вердиктов в блокчейне и проверки репутации других аккаунтов на основе истории их побед, поражений и апелляций.
Для активного участия серверу требуются NEAR account ID и приватный ключ, передаваемые через переменные окружения. Без этих учетных данных сервер работает в режиме только для чтения. Безопасность обеспечивается с помощью специальных ограничений, таких как PSEPHEX_MAX_STAKE_NEAR для лимита индивидуальных залогов, PSEPHEX_BUDGET_NEAR для ограничения общих расходов на процесс и PSEPHEX_ALLOWED_COUNTERPARTIES для ограничения списка аккаунтов, с которыми может взаимодействовать агент. Система поддерживает проверку платежей через NEAR transfers, ft_transfer или x402 signed-delegate payments с использованием доверенных токенов, таких как Circle testnet USDC.
Что вы можете с ним делать
- 1Инициирование официального спораАгент может начать юридическое разбирательство, предоставив претензию, доказательства и залог.
- 2Проверка финансовых расчетовАгент может подтвердить, что конкретный хеш транзакции является валидным платежом, прежде чем использовать его в качестве доказательства.
- 3Оценка надежности агентаРазработчик может дать агенту команду проверить историю побед и поражений другого аккаунта перед проведением транзакции.
- 4Валидация судебных решенийАгент может выполнить проверку подписи контракта оракула, чтобы убедиться в легитимности вердикта.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Psephex MCP
Форматы проверены 10 ноя 2026Установка Psephex MCP в Claude Code
$ claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcpУстановка Psephex MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Установка Psephex MCP в VS Code
.vscode/mcp.json
{
"servers": {
"psephex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Установка Psephex MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Установка Psephex MCP в Codex
~/.codex/config.toml
[mcp_servers.psephex] command = "npx" args = ["-y", "@unitynodes/psephex-mcp"] [mcp_servers.psephex.env] NEAR_PRIVATE_KEY = "<YOUR_NEAR_PRIVATE_KEY>"
Установка Psephex MCP в Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Конфигурация
NEAR_PRIVATE_KEYСекретFunction-call or dedicated agent key for that account, never an owner key
NEAR_ACCOUNT_IDNEAR testnet account the agent acts as; without it the server is read-only
PSEPHEX_ALLOWED_COUNTERPARTIESComma-separated accounts the agent may open cases against
PSEPHEX_BUDGET_NEARCap on everything one server process attaches, in NEAR (default 1)
PSEPHEX_MAX_STAKE_NEARCap on one stake or appeal bond in NEAR (default 0.5)
| Название | Описание | Тип |
|---|---|---|
| NEAR_PRIVATE_KEY | Function-call or dedicated agent key for that account, never an owner key | Секрет |
| NEAR_ACCOUNT_ID | NEAR testnet account the agent acts as; without it the server is read-only | |
| PSEPHEX_ALLOWED_COUNTERPARTIES | Comma-separated accounts the agent may open cases against | |
| PSEPHEX_BUDGET_NEAR | Cap on everything one server process attaches, in NEAR (default 1) | |
| PSEPHEX_MAX_STAKE_NEAR | Cap on one stake or appeal bond in NEAR (default 0.5) |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийunitynodes/psephex is public and reachablegithub.com/unitynodes/psephex ↗Пройдено
- Пакет указывает этот репозиторий как источник@unitynodes/psephex-mcp names unitynodes/psephex as sourcenpmjs.com/package/@unitynodes/psephex-mcp ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-13github.com/unitynodes/psephex ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @unitynodes/psephex-mcpПройдено
- Нет критических уязвимостей в пакете и зависимостяхthe package checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённый endpoint отвечает на MCP handshakeНе проверялось
README
Открыть на GitHubpsephex-mcp
MCP server that lets an AI agent use the Psephex court on NEAR testnet: open a case with its evidence, answer a case it is named in, check a NEAR or x402 payment before citing it, read verdicts and re-check them on chain, and look up another agent's record before paying it.
Claude Code, Claude Desktop or any MCP client (stdio), with Node 22.12 or newer:
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": ["-y", "@unitynodes/psephex-mcp"],
"env": { "NEAR_ACCOUNT_ID": "my-agent.testnet", "NEAR_PRIVATE_KEY": "ed25519:...", "PSEPHEX_MAX_STAKE_NEAR": "0.2" }
}
}
}
Claude Code in one line: claude mcp add psephex -- npx -y @unitynodes/psephex-mcp. From a checkout instead: npm ci && npm run build, then node dist/src/main.js.
Without NEAR_ACCOUNT_ID and NEAR_PRIVATE_KEY the server is read-only. Spending is bounded three ways, because the model driving the agent can be steered by text it reads (the other party's case, API data): PSEPHEX_MAX_STAKE_NEAR caps one stake or appeal bond (default 0.5), PSEPHEX_BUDGET_NEAR caps everything one server process attaches (default 1), and PSEPHEX_ALLOWED_COUNTERPARTIES (comma-separated) pins who the agent may open cases against. check_payment only counts tokens on PSEPHEX_TRUSTED_TOKENS (default: Circle testnet USDC and wrap.testnet) and only when every receipt succeeded. .npmrc sets legacy-peer-deps as in relayer/ and web/: npm 10.9 fails on the vitest peer set otherwise. Use a function-call or dedicated agent key, never an owner key.
| Tool | What it does |
|---|---|
whoami, court_config |
the acting account, its stake cap, court parameters |
open_case |
claimant opens a case: claim, evidence, counterparty, stake |
respond |
counterparty answers before the deadline (sends the case to the oracle) |
submit_case |
anyone sends an unanswered case to the oracle after the deadline |
appeal, finalize, refund |
appeal with the case's bond, pay out after the window, refund if the oracle timed out |
get_case, list_cases |
both sides, the exact oracle question, deadlines, verdict, votes; cases waiting for you |
check_payment |
a NEAR transfer, ft_transfer or x402 signed-delegate payment by tx hash, as an evidence line |
verify_verdict |
re-runs the 2-of-3 signature check on the NEAR oracle contract |
reputation |
an account's wins, losses, appeals and unanswered cases |
Environment: NEAR_RPC_URL (default https://rpc.testnet.fastnear.com), PSEPHEX_COURT (psephex-court.testnet), PSEPHEX_ORACLE (oracle.psephex.testnet), PSEPHEX_API_URL (https://psephex.xyz/api).
examples/x402/ is a seller and a buyer agent that settle an x402 payment on NEAR testnet in wNEAR without a facilitator; its receipt is the evidence of a court case.
Вопросы о Psephex MCP
Как добавить Psephex MCP в Claude Code?
Выполните claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Psephex MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Что произойдет, если я не предоставлю учетные данные NEAR?
Сервер будет работать в режиме только для чтения.
Как я могу ограничить сумму расходов моего агента?
Вы можете ограничить размер ставок и апелляций с помощью PSEPHEX_MAX_STAKE_NEAR, установить лимит общих расходов на процесс через PSEPHEX_BUDGET_NEAR или ограничить круг контрагентов с помощью PSEPHEX_ALLOWED_COUNTERPARTIES.
Какие токены считаются валидными для проверки платежей?
Инструмент check_payment распознает только токены, указанные в PSEPHEX_TRUSTED_TOKENS; по умолчанию это Circle testnet USDC и wrap.testnet.