Unstorage MCP Server

基本能力

产品定位

Unstorage MCP Server 是一个键值存储服务器，旨在提供灵活的数据存储和管理解决方案。

核心功能

• 支持多种存储驱动：内存、文件系统、Redis、HTTP 服务器和 MongoDB。
• 提供丰富的工具集，包括 showMounts()、getItem(key)、setItem(key, value) 等。
• 支持环境变量配置，便于灵活部署。
• 提供扩展指南，支持自定义存储驱动。

适用场景

• 需要灵活存储和管理键值数据的应用。
• 需要多种存储驱动支持的应用。
• 需要快速扩展存储驱动的开发场景。

工具列表

• showMounts(): 显示当前挂载的存储驱动。
• getItem(key): 获取指定键的值。
• getItems(items): 批量获取多个键的值。
• getItemRaw(key): 获取指定键的原始值。
• getMeta(key, nativeOnly): 获取指定键的元数据。
• getKeys(base, maxDepth): 获取指定基路径下的所有键。
• setItem(key, value): 设置指定键的值。
• setItems(items): 批量设置多个键的值。
• setItemRaw(key, value): 设置指定键的原始值。
• setMeta(key, meta): 设置指定键的元数据。
• removeItem(key, removeMeta): 删除指定键及其元数据。
• removeMeta(key): 删除指定键的元数据。

常见问题解答

• 安装问题：Windows 用户可以参考 这篇文章。
• 配置问题：确保环境变量正确设置，特别是存储驱动的 URL 和基路径。

使用教程

使用依赖

无特殊依赖，只需安装 Node.js 和 npm。

安装教程

最小配置

{
  "mcpServers": {
    "unstorage": {
      "command": "npx",
      "args": ["/y", "@slow-groovin/unstorage-mcp"]
    }
  }
}

最大配置

{
  "mcpServers": {
    "unstorage": {
      "command": "npx",
      "env": {
        "REDIS_URL": "redis://default:123456@localhost:6379",
        "REDIS_BASE": "visits:date:api:",
        "REDIS_MOUNT_POINT": "redis_storage",
        "FS_BASE": "D:/tmp",
        "FS_MOUNT_POINT": "fs_storage",
        "HTTP_BASE": "http://localhost:3001",
        "HTTP_MOUNT_POINT": "http_storage",
        "HTTP_HEADERS": "Authorization=Bear 123;A=3;B=4;C=5",
        "MONGODB_URL": "mongodb://root:123456@localhost:27017/",
        "MONGODB_DB_NAME": "test",
        "MONGODB_COLLECTION_NAME": "unstorage",
        "MONGODB_MOUNT_POINT": "mongo_storage"
      },
      "args": ["/y", "@slow-groovin/unstorage-mcp", "--disable-modify"]
    }
  }
}

Windows 用户

{
  "mcpServers": {
    "unstorage": {
      "command": "cmd",
      "args": ["/c", "npx", "/y", "@slow-groovin/unstorage-mcp"]
    }
  }
}

调试方式

使用 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

本地开发配置

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。