Skip to main content
Glama
deenesjakoruzh
arrivets

Arkiv MCP Server

by arrivets
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

Arkiv MCPサーバー

Model Context Protocol (MCP)サーバーであり、AIエージェントやアプリケーションに対して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

機能

  • SQLライクなフィルタ式を使用したArkivデータベースチェーンからのエンティティクエリ

  • 完全なarkiv_query構文：比較、論理演算子、グロブマッチング、合成属性

  • カーソルによるページネーションサポート

  • 設定可能な戻り値フィールド（属性、メタデータ、ペイロード）

  • デフォルトで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

環境変数

変数

説明

必須

ARKIV_NODE_URL

ArkivノードのRPC URL

いいえ（デフォルトはKaolinテストネット）

コマンドラインオプション

オプション

説明

デフォルト

--node-url <url>

ArkivノードのRPC URL

Kaolinテストネット

--help, -h

ヘルプを表示

-

MCPツール

query_entities

Arkivデータベースチェーンからエンティティをクエリします。

パラメータ

パラメータ

型

説明

デフォルト

filter

string

フィルタ式（以下の構文を参照）

$all

limit

number

返されるエンティティの最大数（最大200）

-

cursor

string

前回のレスポンスからのページネーションカーソル

-

withAttributes

boolean

結果に属性を含める

true

withMetadata

boolean

結果にメタデータ（所有者、作成者、有効期限）を含める

true

withPayload

boolean

結果にペイロード（base64エンコード）を含める

true

validAtBlock

number

特定のブロック番号時点の状態をクエリ

-

フィルタ構文

filterパラメータはarkiv_query式言語を使用します：

演算子

説明

例

=

等価

status = "active"

!=

非等価

status != "deleted"

>, >=, <, <=

数値範囲

score > 100

&&

論理AND

type = "post" && score > 50

||

論理OR

status = "active" || status = "pending"

!

否定

!(status = "deleted")

~

グロブマッチ

name ~ "test*"

!~

否定グロブ

name !~ "draft*"

合成属性（$で始まるもの）：

属性

説明

$all

すべてのエンティティに一致

$owner

現在の所有者アドレス

$creator

元の作成者アドレス（不変）

$key

エンティティキー

フィルタの例

# 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-mcp/
├── src/
│   └── index.ts          # Main server implementation
├── package.json
├── tsconfig.json
└── README.md

ライセンス

MIT

Install Server
F
license - not found
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/arrivets/arkiv-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server