Skip to main content
Glama
deenesjakoruzh
arrivets

Arkiv MCP Server

by arrivets
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

Arkiv MCP 서버

AI 에이전트와 애플리케이션에 Arkiv 데이터베이스 체인 쿼리 기능을 제공하는 Model Context Protocol (MCP) 서버입니다.

빠른 시작

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의 모든 엔티티 쿼리"

  • "type = "post"이고 score > 10인 모든 Arkiv 엔티티 찾기"

  • "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

&&

논리 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