article
README
🚀 Upstash MCP 服务器使用指南
本指南将介绍 Upstash 的 MCP 服务器的安装、运行配置、问题排查、进阶使用、开发说明、工具列表以及联系方式等内容。
🚀 快速开始
安装说明
- 使用
npx或docker安装 Upstash 的 MCP 服务器。npx @upstash/mcp-server install - 如果使用 Docker,请参考以下命令构建镜像:
docker build -t upstash-mcp .
运行配置
- 在终端中运行以下命令,获取
npx或docker的完整路径,并替换 MCP 配置文件中的相关命令。which npx 或者 which docker - 如果使用 Node Version Manager(如
nvm或fnm),请参考 此问题,将 MCP 配置文件中的node命令替换为 Node 的完整路径。
🔍 通用问题排查
常见问题
如果 MCP 客户端因 PATH 环境变量的差异而无法找到正确的二进制文件,可以通过以下步骤解决:
- 在终端中运行
which npx或which docker,获取其完整路径。 - 将这些路径替换到 MCP 配置文件中的相应命令中。
Node 管理工具
使用 nvm 或 fnm 的用户,请确保将 MCP 配置文件中的 node 命令替换为 Node.js 的完整路径,以避免版本冲突问题。
📚 详细文档
进阶说明
Docker 运行示例
docker run --rm -i \
-e UPSTASH_EMAIL=<UPSTASH_EMAIL> \
-e UPSTASH_API_KEY=<UPSTASH_API_KEY> \
upstash-mcp
环境变量配置
创建一个 .env 文件,内容如下:
UPSTASH_EMAIL=<你的 Upstash 邮箱>
UPSTASH_API_KEY=<你的 Upstash API 密钥>
开发说明
本地开发
pnpm install
pnpm run watch
这将持续构建项目并实时跟踪代码变化。
Claude Desktop 配置
- 执行以下命令安装本地配置:
pnpm run setup
- 在 MCP 配置文件中添加
upstash条目,指向本地构建的包:
{
"upstash": {
"command": "node",
"args": ["<项目路径>/dist/index.js", "run", "<UPSTASH_EMAIL>", "<UPSTASH_API_KEY>"]
}
}
日志查看
执行以下命令实时查看 MCP 服务器的日志:
pnpm run logs
工具列表
Redis 相关工具
redis_database_create_backupredis_database_create_newredis_database_deleteredis_database_delete_backupredis_database_restore_from_backup- 更多工具请参考 官方文档。
扫码加入微信群