MCP 服务器

shelby-mcp

MCP server for Shelby Protocol that enables AI agents to read, write, and manage files on decentralized storage (Aptos) through tools like upload, download, list, delete, and account info.

README

shelby-mcp

MCP server for Shelby Protocol — connect AI agents to decentralized storage.

Works with Claude Desktop, Cursor, Claude Code, Codex, and any MCP-compatible client.

What it does

AI agents can read, write, and manage files on Shelby's decentralized storage network (Aptos) through 5 tools:

Tool	Description
`shelby_upload`	Upload text content to Shelby storage
`shelby_download`	Download a blob and return its content
`shelby_list`	List blobs under current account
`shelby_delete`	Delete a blob
`shelby_account`	Show account info, balance, network

Prerequisites

Node.js v18+
Shelby CLI installed and configured (npm install -g @shelby-protocol/cli)
A funded Shelby account (shelby faucet)

Install

git clone https://github.com/Jasekeee/shelby-mcp.git
cd shelby-mcp
npm install
npm run build

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Restart Claude Desktop. You can now say:

"Upload this report to Shelby as reports/q1-2026.txt"

"Download my config from Shelby"

"What's my Shelby account balance?"

Use with Cursor

Add to .cursor/mcp.json in your project:

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

Use with Claude Code

claude mcp add shelby node /absolute/path/to/shelby-mcp/build/index.js

Architecture

AI Agent (Claude/Cursor/Codex)
    ↕ MCP Protocol (stdio)
shelby-mcp server
    ↕ CLI wrapper
shelby CLI → Aptos blockchain → Shelby storage network

The server wraps the shelby CLI rather than using the SDK directly. This ensures compatibility across CLI versions and avoids SDK breaking changes.

Configuration

shelby-mcp reads from your existing ~/.shelby/config.yaml. No additional configuration needed — if shelby upload works in your terminal, it works through MCP.