Unstorage MCP

A key-value storage MCP server based on unjs/unstorage, supporting multiple storage drivers such as memory, file system, Redis, HTTP server, and MongoDB, and providing rich storage operation tools.

Developer tools Cloud storage #Key-value storage #Multi-driver #MCP service #Storage tool .TypeScript

rating : 2 points

downloads : 7.7K

update time : 2025-04-29

Open Site

What is Unstorage MCP Server?

Unstorage MCP Server is a key-value storage server based on unjs/unstorage, providing multiple storage drivers and a toolset that can be easily integrated into your project. It supports multiple storage methods such as memory, file system, Redis, and MongoDB.

How to use Unstorage MCP Server?

You can start the server through simple configuration and support the combined use of multiple storage drivers. You can configure different storage backends through environment variables and perform data operations through the provided toolset.

Applicable scenarios

Suitable for projects that require flexible storage solutions, especially application scenarios that need to support multiple storage backends.

Main features

Multi-storage driver support

Supports multiple storage drivers such as memory, file system, Redis, and MongoDB

Rich toolset

Provides multiple data operation tools including getItem, setItem, getKeys, etc.

Flexible configuration

Flexible configuration through environment variables and command-line parameters

Advantages

Supports multiple storage backends with strong flexibility

Simple configuration and easy to integrate

Provides a rich API toolset

Limitations

Currently, the supported storage drivers are limited

Requires a certain technical background for configuration

How to use

Installation

Install via npm or run directly using npx

Configuration

Configure the storage driver through environment variables

Running

Start the server

Usage examples

Basic configuration example

Configure Redis as the storage backend

Multi-storage configuration

Configure both Redis and file system storage

Frequently Asked Questions

How to install on Windows?

How to add a new storage driver?

Related resources

unjs/unstorage documentation

Documentation for the unstorage project

Windows client installation tutorial

Detailed tutorial for installing MCP on Windows systems

🚀 Unstored Server

The Unstored Server is a storage - related server that provides flexible configuration options and easy - to - expand features, helping users quickly build storage services.

🚀 Quick Start

📦 Installation

Minimum Configuration

{
  "unstorage": {
    "adapter": "default"
  }
}

Maximum Configuration

{
  "unstorage": {
    "adapter": "default",
    "options": {
      "host": "localhost",
      "port": 3001,
      "prefix": "/api/v1/storage"
    }
  }
}

🌐 Environment Variables

Redis Configuration

UNSTORAGE_REDIS_URL=redis://default:password@localhost:6379
UNSTORAGE_REDIS_BASE=my:mcp:values:
UNSTORAGE_REDIS_MOUNTPOINT=/my/redis/mountpoint

HTTP Server Configuration

UNSTORAGE_HTTP_BASE=http://localhost:3001
UNSTORAGE_HTTP_MOUNTPOINT=/http/mountpoint
UNSTORAGE_HTTP_HEADERS="Authorization=Bear 123;A=1;B=2"

File System Configuration

UNSTORAGE_FS_BASE=/path/to/base/directory
UNSTORAGE_FS_MOUNTPOINT=/fs/mountpoint

🛠️ Extension Guide

Clone this repository.
Copy src/storage/redis.ts to a new file and modify it according to your needs (the learning curve of unjs/unstorage is very friendly).
Test and verify the effects.
(Optional) Submit a merge request.

If you are not a TypeScript developer, please submit an issue to request support for other drivers.

Tips for Cursor/Cline Assisted Programming

@/src/storage/mongodb.ts, please implement this file:
1. You need to use the corresponding documentation URL of the storage type (https://unstorage.unjs.io/drivers/<storage type>) to obtain information.
2. You can refer to the examples in @/src/adapter/redis.ts and @/src/storage/http.ts.
3. You only need to generate the code without performing tests.

> If you haven't installed the fetch MCP server, please delete the first sentence.

🐞 Debugging Methods

Using mcp - inspector

mcp-inspector -e HTTP_BASE=http://localhost:3001 -e HTTP_MOUNT_POINT=http_storage -e FS_BASE=D:/temp -e FS_MOUNT_POINT=fs_storage -e HTTP_HEADERS="Authorization=Bear 123;" tsx ./src/index.ts

Using tsx for Local Development Configuration

{
  "mcpServers": {
    "command": "cmd",
    "env": {
      "REDIS_URL": "redis://default:password@localhost:6379",
      "REDIS_BASE": "my:mcp:values:",
      "REDIS_MOUNT_POINT": "/my/redis/mountpoint"
    },
    "args": ["/c", "tsx", "D:/xxx/projects/unstorage-mcp/src/index.ts"]
  }
}