Skip to main content
Glama
deenesjakoruzh
arrivets

Arkiv MCP Server

by arrivets
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

Arkiv MCP 服务器

一个 模型上下文协议 (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 工具。示例提示词：

  • "查询 Arkiv 上的所有实体"

  • "查找 Arkiv 中所有 type = "post" 且 score > 10 的实体"

  • "显示 Arkiv 测试网上由 0x1234... 拥有的实体"

  • "获取匹配 status = "active" 的前 5 个实体，然后进行分页"

Related MCP server: TextQL MCP Server

功能特性

  • 使用类似 SQL 的过滤表达式查询 Arkiv 数据库链中的实体

  • 完整的 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

环境变量

变量

描述

是否必须

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

&&

逻辑与

type = "post" && score > 50

||

逻辑或

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

!

取反

!(status = "deleted")

~

Glob 匹配

name ~ "test*"

!~

取反 Glob 匹配

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