Arkiv MCP Server

Сервер Model Context Protocol (MCP), который предоставляет ИИ-агентам и приложениям возможности запроса цепочек баз данных Arkiv.

Быстрый старт

1. Сборка

cd arkiv-mcp
npm install
npm run build

2. Добавление в Claude Code

Запустите это из директории arkiv-mcp:

claude mcp add arkiv -- node $(pwd)/dist/index.js

Или добавьте вручную в ~/.claude/settings.json:

{
  "mcpServers": {
    "arkiv": {
      "command": "node",
      "args": ["/absolute/path/to/arkiv-mcp/dist/index.js"]
    }
  }
}

Для Claude Desktop добавьте тот же блок в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows).

3. Запрос к тестовой сети Kaolin

После подключения станет доступен инструмент query_entities. Примеры промптов:

• "Query all entities on Arkiv"

• "Find all Arkiv entities where type = "post" and score > 10"

• "Show me entities owned by 0x1234... on the Arkiv testnet"

• "Get the first 5 entities matching status = "active", then paginate"

Related MCP server: TextQL MCP Server

Функции

• Запрос сущностей из цепочек баз данных Arkiv с использованием SQL-подобных выражений фильтрации

• Полный синтаксис arkiv_query: сравнения, логические операторы, glob-сопоставление, синтетические атрибуты

• Поддержка пагинации с помощью курсора

• Настраиваемые возвращаемые поля (атрибуты, метаданные, полезная нагрузка)

• По умолчанию используется тестовая сеть Kaolin

Установка

cd arkiv-mcp
npm install
npm run build

# Or use tsx for development
npm run dev

Использование

Запуск сервера

# Using default Kaolin testnet
npm start

# With custom node URL
npm start -- --node-url https://your-arkiv-node.rpc

# Or with tsx for development
npm run dev -- --node-url https://your-arkiv-node.rpc

Переменные окружения

Параметры командной строки

Инструмент MCP

query_entities

Запрос сущностей из цепочки баз данных Arkiv.

Параметры

Синтаксис фильтра

Параметр filter использует язык выражений arkiv_query:

Синтетические атрибуты (с префиксом $) :

Примеры фильтров

# All entities
$all

# By entity key
$key = "0xabc123..."

# By owner or creator
$owner = "0x1234567890abcdef..."
$creator = "0x1234567890abcdef..."

# Attribute equality
status = "active"
type = "post"

# Numeric range
score > 100
price >= 50 && price <= 200

# Compound
project = "myapp" && type = "post" && score > 10

# Glob matching
name ~ "draft*"
!(status = "deleted")

Формат ответа

{
  "entities": [
    {
      "key": "0x...",
      "owner": "0x...",
      "creator": "0x...",
      "createdAtBlock": "12345",
      "lastModifiedAtBlock": "12350",
      "expiresAtBlock": "99999",
      "contentType": "application/json",
      "payload": "<base64-encoded bytes>",
      "attributes": [
        { "key": "type", "value": "post" },
        { "key": "score", "value": 42 }
      ]
    }
  ],
  "cursor": "0x2a",
  "blockNumber": "12350",
  "count": 1
}

Для пагинации передайте полученный cursor обратно в качестве параметра cursor в следующем вызове. Если cursor отсутствует, значит, результатов больше нет.

Разработка

Сервер использует:

• @arkiv-network/sdk — Arkiv TypeScript SDK

• @modelcontextprotocol/sdk — MCP Server SDK

Структура проекта

arkiv-mcp/
├── src/
│   └── index.ts          # Main server implementation
├── package.json
├── tsconfig.json
└── README.md

Лицензия

MIT