一个 Redis 模型上下文协议 (MCP) 服务器实现,可用于与 Redis 数据库进行交互。通过该服务器,大型语言模型 (LLMs) 能够借助一组标准化工具与 Redis 键值存储开展交互操作。
本部分将为您介绍 Redis MCP 服务器的安装与使用方法。
您可以通过 Smithery 为 Claude Desktop 自动安装 Redis MCP Server:
npx -y @smithery/cli install @gongrzhe/server-redis-mcp --client claude
您可以选择使用 npx 指定版本进行安装(推荐):
npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port
# 示例:
npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379
或者进行全局安装:
# 全局安装指定版本
npm install -g @gongrzhe/server-redis-mcp@1.0.0
# 安装后运行
@gongrzhe/server-redis-mcp redis://your-redis-host:port
set
key
(字符串):Redis 键。value
(字符串):需要存储的值。expireSeconds
(数字,可选):过期时间(秒)。get
key
(字符串):要检索的 Redis 键。delete
key
(字符串 | 字符串数组):键或键数组。list
pattern
(字符串,可选):匹配键的模式(默认值:*)。62 个 Redis MCP 工具位于 此处。
若要将此服务器与 Claude Desktop 应用配合使用,请在 claude_desktop_config.json
的 "mcpServers" 部分添加以下配置:
{
"mcpServers": {
"redis": {
"command": "npx",
"args": [
"@gongrzhe/server-redis-mcp@1.0.0",
"redis://localhost:6379"
]
}
}
}
或者,如果您已经安装了该包,则可以直接使用 node 命令:
{
"mcpServers": {
"redis": {
"command": "node",
"args": [
"path/to/build/index.js",
"redis://10.1.210.223:6379"
]
}
}
}
在 Docker 中运行此服务器的命令如下:
docker run -p 3000:3000 ghcr.io/gongrzhe/server-redis-mcp:1.0.0
运行后,您可以通过访问 http://localhost:3000 来使用服务器。
您可以按照以下步骤从源代码构建服务器:
npm install
npm run build
以下是使用 Docker 部署服务器的详细步骤:
# 使用基础镜像
FROM node:18
# 设置工作目录
WORKDIR /app
# 复制包文件
COPY package*.json ./
# 安装依赖
RUN npm install --production
# 复制应用代码
COPY . .
# 暴露端口
EXPOSE 3000
# 运行服务器
CMD ["npm", "start"]
构建并运行 Docker 容器的命令如下:
docker build -t server-redis-mcp:1.0.0 .
docker run -p 3000:3000 server-redis-mcp:1.0.0
通过上述步骤,您可以轻松设置和使用 Redis MCP 服务器。