MCP Tools Collection

🌟 核心工具 - Redis 管理服务器

🚀 MCP Redis Server - 企业级 Redis 管理工具:完整 Redis 操作支持、细粒度权限控制、智能连接池、操作审计日志,专为生产环境设计的 AI 原生 Redis 管理解决方案

包名: @liangshanli/mcp-server-redis
NPM: https://www.npmjs.com/package/@liangshanli/mcp-server-redis
GitHub: https://github.com/liliangshan/mcp-server-redis

✨ 核心特性
  • 🔧 完整 Redis 操作: 支持所有 Redis 数据类型的 GET、SET、UPDATE、DELETE 操作
  • 🛡️ 动态权限控制: 基于环境变量的独立权限管理 (INSERT/UPDATE/DELETE/CREATE/DROP)
  • 📊 智能工具列表: 根据权限动态显示/隐藏可用工具
  • 🔄 连接管理: 自动重连、健康检查、连接池优化
  • 📝 操作日志: 完整的审计日志和错误追踪
  • 🌐 多语言支持: 中英文文档和界面
🚀 独特优势

🎯 企业级安全控制

  • 细粒度权限: 每个操作类型独立控制,支持只读、读写、完全权限等模式
  • 动态工具列表: 根据权限自动显示/隐藏工具,避免误操作
  • 审计日志: 完整记录所有操作,满足企业合规要求
  • 安全模式: 默认只读模式,防止意外数据修改

⚡ 高性能连接管理

  • 智能连接池: 自动管理连接,提高性能
  • 自动重连: 连接断开时自动恢复,确保服务连续性
  • 健康检查: 定期检查连接状态,预防性维护
  • 优雅关闭: 服务器关闭时正确释放资源

🔧 开发友好设计

  • 零配置启动: 默认配置即可使用,开箱即用
  • 环境变量配置: 灵活的配置管理,支持多环境部署
  • 详细错误信息: 清晰的错误提示,便于调试
  • 多编辑器支持: 完美集成 Cursor、VS Code 等编辑器

📊 运维监控能力

  • 实时监控: 连接状态、内存使用、操作统计
  • 性能指标: 响应时间、吞吐量、错误率统计
  • 日志管理: 结构化日志,便于分析和排查问题
  • 健康检查: 自动检测服务状态,及时发现问题

🌍 生产环境就绪

  • 高可用性: 自动故障恢复,确保服务稳定
  • 可扩展性: 支持大规模部署和负载均衡
  • 安全性: 企业级安全控制,满足合规要求
  • 可维护性: 完善的日志和监控,便于运维管理

一套完整的 Model Context Protocol (MCP) 工具集,为 AI 辅助开发提供强大的数据库管理、项目标准管理和资源管理能力。

🌟 关于 MCP Tools Collection

在当今快速发展的 AI 辅助开发时代,开发者需要一个强大、安全、易用的工具集来管理复杂的开发环境。MCP Tools Collection 正是为此而生的企业级解决方案,它基于 Model Context Protocol (MCP) 标准,为现代开发团队提供了一套完整的工具生态系统。

🎯 核心价值主张

企业级 Redis 管理是我们的核心产品,它不仅仅是一个简单的 Redis 客户端,而是一个专为生产环境设计的企业级管理平台。在微服务架构日益普及的今天,Redis 作为高性能缓存和会话存储的核心组件,其管理复杂度也在不断增长。我们的 Redis 工具通过动态权限控制、智能连接管理、实时监控告警等特性,让企业能够安全、高效地管理 Redis 集群,确保数据安全和系统稳定性。

安全优先的设计理念贯穿整个工具集。我们深知在企业环境中,数据安全是首要考虑因素。因此,我们采用了细粒度的权限控制机制,支持只读、读写、完全权限等多种安全级别,并且默认采用只读模式,防止意外数据修改。动态工具列表功能根据用户权限自动显示或隐藏危险操作,从根本上避免了误操作的可能性。

🚀 技术创新亮点

智能连接管理是我们在技术上的重要突破。传统的 Redis 管理工具往往存在连接管理复杂、故障恢复困难等问题。我们的解决方案通过智能连接池、自动重连机制、健康检查等特性,实现了连接的高可用性和高性能。即使在网络不稳定的环境下,系统也能自动检测故障并快速恢复,确保业务连续性。

AI 原生设计让我们的工具完美适配现代 AI 辅助开发工作流。通过 MCP 协议,我们的工具能够与 Cursor、VS Code 等主流编辑器无缝集成,为 AI 助手提供强大的 Redis 操作能力。AI 可以智能地执行 Redis 操作、分析性能数据、提供优化建议,大大提升了开发效率。

🏢 企业级特性

完整的审计体系满足企业合规要求。我们提供详细的操作日志、安全事件记录、性能监控数据,让企业能够完整追踪所有 Redis 操作,满足各种合规审计要求。这对于金融、医疗、政府等对数据安全要求极高的行业尤为重要。

多环境支持让企业能够在开发、测试、生产等不同环境中使用统一的工具集。通过环境变量配置,可以轻松切换不同的 Redis 实例,确保环境隔离和配置一致性。

🌍 生态系统价值

除了 Redis 管理工具,我们还提供 MySQL、SQL Server 数据库管理工具,项目标准管理工具,图标资源管理工具等,形成了一个完整的开发工具生态系统。这些工具都基于相同的 MCP 协议,可以无缝协作,为开发团队提供一站式的解决方案。

团队协作优化是我们的另一个重要价值。通过统一的工具集和标准,确保团队成员使用相同的开发规范,减少代码风格差异,提高代码质量。新团队成员可以快速上手,减少培训成本。

🔮 未来展望

随着 AI 技术的不断发展,我们相信 MCP Tools Collection 将成为 AI 辅助开发的重要基础设施。我们持续投入研发,不断优化工具性能,增加新功能,确保我们的工具始终处于技术前沿,为开发者提供最佳的使用体验。

无论是初创公司还是大型企业,无论是个人开发者还是开发团队,MCP Tools Collection 都能为您提供专业、安全、高效的开发工具支持。让我们一起拥抱 AI 辅助开发的新时代,用更好的工具创造更优秀的软件。

🎯 主要功能
# 数据操作
✅ get_data      - 根据键获取数据
✅ set_data      - 设置/插入键数据  
✅ update_data   - 更新现有数据
✅ delete_data   - 删除数据
✅ list_keys     - 列出键,支持模式匹配

# 键管理
✅ create_key    - 创建新键
✅ drop_key      - 删除键
✅ exists_key    - 检查键是否存在
✅ get_key_info  - 获取键详细信息
✅ rename_key    - 重命名键
✅ set_ttl       - 设置生存时间
✅ remove_ttl    - 移除生存时间

# 系统监控
✅ get_redis_info      - Redis 服务器信息
✅ get_database_stats  - 数据库统计
✅ get_memory_info     - 内存使用信息
✅ test_connection     - 连接测试
✅ get_operation_logs  - 操作日志
✅ check_permissions   - 权限检查
🚀 快速开始
# 1. 安装
npm install -g @liangshanli/mcp-server-redis

# 2. 配置环境变量
export HOST=localhost
export PORT=6379
export PASSWORD=your_password
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=true
export ALLOW_CREATE=true
export ALLOW_DROP=true

# 3. 启动服务器
mcp-server-redis
🔧 编辑器集成

Cursor 配置 (.cursor/mcp.json):

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-redis"],
      "env": {
        "HOST": "localhost",
        "PORT": "6379",
        "PASSWORD": "your_password",
        "ALLOW_INSERT": "true",
        "ALLOW_UPDATE": "true",
        "ALLOW_DELETE": "true",
        "ALLOW_CREATE": "true",
        "ALLOW_DROP": "true"
      }
    }
  }
}
🛡️ 权限控制示例
# 只读模式 (安全模式)
export ALLOW_INSERT=false
export ALLOW_UPDATE=false
export ALLOW_DELETE=false
export ALLOW_CREATE=false
export ALLOW_DROP=false

# 允许插入和更新,禁用删除
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=false
export ALLOW_CREATE=true
export ALLOW_DROP=false

# 完全权限 (开发环境)
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=true
export ALLOW_CREATE=true
export ALLOW_DROP=true

🗄️ 数据库管理工具集

MySQL 数据库服务器

包名: @liangshanli/mcp-server-mysql
NPM: https://www.npmjs.com/package/@liangshanli/mcp-server-mysql
GitHub: https://github.com/liliangshan/mcp-server-mysql
功能: DDL 支持、权限控制、操作日志、连接池管理

npm install -g @liangshanli/mcp-server-mysql

核心特性:

  • ✅ SQL 查询执行 (DDL 和 DML)
  • ✅ 数据库信息检索
  • ✅ 操作日志记录
  • ✅ 连接池管理
  • ✅ 自动重连机制
  • ✅ 健康检查和错误处理

SQL Server 数据库服务器

包名: @liangshanli/mcp-server-mssqlserver
NPM: https://www.npmjs.com/package/@liangshanli/mcp-server-mssqlserver
GitHub: https://github.com/liliangshan/mcp-server-mssqlserver
功能: 企业级 SQL Server 支持、高级 DDL、权限控制

npm install -g @liangshanli/mcp-server-mssqlserver
🚀 企业级 SQL Server 管理

核心特性:

  • 完整 SQL 支持: 支持所有 DDL 和 DML 操作,包括复杂的存储过程、触发器、视图管理
  • 高级权限控制: 细粒度的 DDL、DROP、DELETE 权限控制,支持企业级安全策略
  • 综合日志记录: 完整的请求/响应日志、SQL 操作跟踪、连接池监控
  • 企业级连接管理: 自动连接池创建、健康监控、故障恢复机制
  • MCP 协议兼容: 完整的 Model Context Protocol 实现,支持工具发现和执行
  • 多编辑器支持: 完美集成 Cursor、VS Code 等主流编辑器
🛡️ 企业级安全特性

权限控制示例:

# 开发环境 (高权限)
export ALLOW_DDL=true
export ALLOW_DROP=true
export ALLOW_DELETE=true

# 测试环境 (中等权限)
export ALLOW_DDL=true
export ALLOW_DROP=false
export ALLOW_DELETE=true

# 生产环境 (受限权限)
export ALLOW_DDL=false
export ALLOW_DROP=false
export ALLOW_DELETE=false

连接配置:

export MSSQL_SERVER=your-mssql-server.com
export MSSQL_PORT=1433
export MSSQL_USER=your-username
export MSSQL_PASSWORD=your-secure-password
export MSSQL_DATABASE=your-database
export MSSQL_SCHEMA=your-schema
export MSSQL_ENCRYPT=false
export MSSQL_TRUST_SERVER_CERTIFICATE=true
🔧 主要功能

SQL 操作:

  • sql_query - 执行 SQL 查询,支持 DDL 和 DML
  • get_database_info - 获取数据库信息和配置
  • get_operation_logs - 访问详细的操作日志
  • check_permissions - 验证当前权限配置

企业级特性:

  • Schema 自动前缀: 多租户环境的自动 Schema 处理
  • 连接池优化: 智能连接复用和性能调优
  • 错误处理: 全面的错误日志和优雅的故障恢复
  • 安全特性: SQL 注入防护、参数化查询支持、操作验证

🎨 项目管理工具集

项目标准管理服务器

包名: @liangshanli/mcp-server-project-standards
NPM: https://www.npmjs.com/package/@liangshanli/mcp-server-project-standards
GitHub: https://github.com/liliangshan/mcp-server-project-standards
功能: 项目标准管理、API 调试、团队协作

npm install -g @liangshanli/mcp-server-project-standards

核心特性:

  • ✅ 项目信息管理
  • ✅ 项目结构分析
  • ✅ API 接口标准
  • ✅ 开发标准管理
  • ✅ 数据库标准
  • ✅ API 调试工具
  • ✅ 配置管理
  • ✅ 自动重启和健康检查

图标资源管理服务器

包名: @liangshanli/mcp-server-icon
NPM: https://www.npmjs.com/package/@liangshanli/mcp-server-icon
GitHub: https://github.com/liliangshan/mcp-server-icon
功能: 图标搜索、资源管理、多语言支持

npm install -g @liangshanli/mcp-server-icon

核心特性:

  • ✅ 图标搜索 (iconfont.cn)
  • ✅ 图标详情获取
  • ✅ SVG 内容获取
  • ✅ 内置缓存
  • ✅ 缓存管理
  • ✅ 零依赖设计

🚀 完整开发解决方案

全栈开发工具链

# 1. 数据库管理
npm install -g @liangshanli/mcp-server-redis      # Redis 管理
npm install -g @liangshanli/mcp-server-mysql      # MySQL 管理  
npm install -g @liangshanli/mcp-server-mssqlserver # SQL Server 管理

# 2. 项目管理
npm install -g @liangshanli/mcp-server-project-standards # 项目标准
npm install -g @liangshanli/mcp-server-icon              # 图标资源

统一编辑器配置

完整 Cursor 配置 (.cursor/mcp.json):

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-redis"],
      "env": {
        "HOST": "localhost",
        "PORT": "6379",
        "PASSWORD": "your_redis_password",
        "ALLOW_INSERT": "true",
        "ALLOW_UPDATE": "true",
        "ALLOW_DELETE": "true",
        "ALLOW_CREATE": "true",
        "ALLOW_DROP": "true"
      }
    },
    "mysql": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your_mysql_password",
        "MYSQL_DATABASE": "your_database",
        "ALLOW_DDL": "true",
        "ALLOW_DROP": "false",
        "ALLOW_DELETE": "true"
      }
    },
    "mssqlserver": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-mssqlserver"],
      "env": {
        "MSSQL_SERVER": "your-mssql-server.com",
        "MSSQL_PORT": "1433",
        "MSSQL_USER": "your_username",
        "MSSQL_PASSWORD": "your_mssql_password",
        "MSSQL_DATABASE": "your_database",
        "MSSQL_SCHEMA": "your_schema",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true",
        "ALLOW_DDL": "true",
        "ALLOW_DROP": "false",
        "ALLOW_DELETE": "true"
      }
    },
    "project-standards": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-project-standards"],
      "env": {
        "CONFIG_DIR": "./.setting",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE"
      }
    },
    "icon": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-icon"],
      "env": {
        "LANGUAGE": "zh-CN",
        "WEB_SERVER_AUTO_OPEN": "true"
      }
    }
  }
}

🎯 应用场景

🏢 企业级 Redis 管理

  • 生产环境监控: 实时监控 Redis 性能、内存使用、连接状态
  • 数据安全管理: 细粒度权限控制,防止误操作和数据泄露
  • 运维自动化: 自动健康检查、故障恢复、性能优化
  • 合规审计: 完整的操作日志,满足企业合规要求
  • 多环境管理: 开发、测试、生产环境的统一管理

👥 团队协作开发

  • 多开发者环境: 确保每个开发者的 AI 助手遵循相同的项目标准
  • 权限分级管理: 不同角色使用不同权限级别,确保数据安全
  • 统一开发标准: 团队使用统一的 Redis 操作规范
  • 代码审查: 统一的代码风格和标准,减少审查时间
  • 新团队成员培训: 快速帮助新成员了解项目标准和最佳实践

🚀 微服务架构

  • 服务间通信: 统一的 Redis 配置和管理标准
  • 缓存策略: 智能缓存管理和性能优化
  • 数据一致性: 确保分布式环境下的数据一致性
  • 服务发现: 基于 Redis 的服务注册和发现
  • 负载均衡: 支持 Redis 集群和负载均衡

🤖 AI 辅助开发

  • 智能代码生成: AI 生成符合项目标准的 Redis 操作代码
  • 自动重构: 基于标准自动优化和重构 Redis 相关代码
  • 标准检查: 实时检查 Redis 操作是否符合项目标准
  • 性能优化: AI 辅助的 Redis 性能调优建议
  • 最佳实践: 自动应用 Redis 最佳实践和设计模式

🔧 开发运维一体化

  • DevOps 集成: 与 CI/CD 流程无缝集成
  • 监控告警: 实时监控 Redis 状态,及时发现问题
  • 自动化部署: 支持容器化部署和自动化运维
  • 故障排查: 详细的日志和错误信息,快速定位问题
  • 性能调优: 基于监控数据的性能优化建议

🛡️ 安全特性

🔐 Redis 企业级安全

  • 动态权限控制: 基于环境变量的实时权限管理,支持细粒度操作控制
  • 安全模式默认: 默认只读模式,防止意外数据修改
  • 操作审计: 完整记录所有 Redis 操作,满足企业合规要求
  • 权限分级: 支持只读、读写、完全权限等多种安全级别
  • 工具动态隐藏: 根据权限自动隐藏危险操作工具,避免误操作

🛡️ 数据安全保护

  • 数据加密: 支持 Redis 连接加密,保护数据传输安全
  • 访问控制: 基于 IP、用户、角色的多层访问控制
  • 操作验证: 所有 Redis 操作前的权限验证
  • 敏感数据保护: 自动识别和保护敏感数据
  • 安全日志: 详细的安全事件日志,便于安全审计

🔒 连接安全

  • 加密连接: 支持 SSL/TLS 加密连接
  • 证书验证: 可配置的证书信任设置
  • 连接池安全: 安全的连接管理和复用
  • 超时保护: 可配置的连接和请求超时
  • 防重放攻击: 支持请求签名和防重放机制

📊 安全监控

  • 实时监控: 监控异常操作和可疑行为
  • 安全告警: 自动检测和报告安全事件
  • 访问日志: 详细的访问记录和审计跟踪
  • 性能监控: 监控 Redis 性能指标,及时发现异常
  • 故障恢复: 自动故障检测和恢复机制

📊 监控和日志

🔍 Redis 专业监控

  • Redis 性能监控: 实时监控 Redis 服务器性能、内存使用、连接数
  • 操作统计: 详细的 Redis 操作统计,包括 GET/SET/DELETE 等操作计数
  • 内存分析: Redis 内存使用情况分析,包括键空间、过期键等
  • 连接监控: 实时监控 Redis 连接状态、连接池使用情况
  • 性能指标: 响应时间、吞吐量、错误率等关键性能指标

📝 企业级日志系统

  • 操作审计日志: 完整记录所有 Redis 操作,满足企业合规要求
  • 安全事件日志: 记录权限验证、异常操作等安全事件
  • 性能日志: 详细的性能数据日志,便于性能分析和优化
  • 错误日志: 完整的错误信息和堆栈跟踪,便于问题排查
  • 系统日志: 服务器启动/关闭、配置更改等系统事件

🚨 智能告警系统

  • 实时告警: 基于阈值和规则的实时告警机制
  • 异常检测: 自动检测 Redis 性能异常和错误
  • 健康检查: 定期检查 Redis 服务健康状态
  • 故障预测: 基于历史数据的故障预测和预防
  • 自动恢复: 检测到故障时的自动恢复机制

📈 数据分析能力

  • 趋势分析: Redis 性能趋势分析和预测
  • 容量规划: 基于历史数据的容量规划建议
  • 优化建议: 基于监控数据的性能优化建议
  • 报告生成: 自动生成监控报告和分析报告
  • 可视化展示: 丰富的图表和仪表板展示

🚀 快速开始指南

1. 选择您的工具

# Redis 管理 (推荐)
npm install -g @liangshanli/mcp-server-redis

# MySQL 管理
npm install -g @liangshanli/mcp-server-mysql

# SQL Server 管理
npm install -g @liangshanli/mcp-server-mssqlserver

# 项目标准管理
npm install -g @liangshanli/mcp-server-project-standards

# 图标资源管理
npm install -g @liangshanli/mcp-server-icon

2. 配置环境变量

# Redis 配置
export HOST=localhost
export PORT=6379
export PASSWORD=your_redis_password

# MySQL 配置  
export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=root
export MYSQL_PASSWORD=your_mysql_password
export MYSQL_DATABASE=your_database

# SQL Server 配置
export MSSQL_SERVER=your-mssql-server.com
export MSSQL_PORT=1433
export MSSQL_USER=your_username
export MSSQL_PASSWORD=your_mssql_password
export MSSQL_DATABASE=your_database
export MSSQL_SCHEMA=your_schema
export MSSQL_ENCRYPT=false
export MSSQL_TRUST_SERVER_CERTIFICATE=true

3. 配置编辑器

创建 .cursor/mcp.json 文件,添加相应的服务器配置。

4. 重启编辑器

重启 Cursor 编辑器以加载新的 MCP 服务器配置。

5. 开始使用

在 Cursor 的 MCP 界面中使用各种工具进行开发。


📚 文档和资源

官方文档

相关链接

工具 GitHub 仓库


🤝 贡献和支持

贡献指南

  1. Fork 仓库
  2. 创建功能分支
  3. 进行更改
  4. 添加测试(如适用)
  5. 提交拉取请求

支持渠道

  • GitHub Issues: 报告错误和请求功能
  • 文档: 综合指南和示例
  • 示例: 工作示例和用例
  • 社区: 加入我们的开发者社区

📄 许可证

MIT License - 查看 LICENSE 文件了解详情


🔧 其他开发工具

除了 MCP 工具集,我们还提供其他开发工具来完善您的开发环境:

Git 管理工具 (mgit)

GitHub: https://github.com/liliangshan/mgit
功能: Git 仓库管理、分支操作、提交管理

🚀 企业级 Git 管理优势

多项目管理能力:

  • 批量操作: 一键管理多个 Git 项目,大幅提升工作效率
  • 智能分支管理: 自动检测和切换分支,避免冲突和错误
  • 远程数据库同步: 支持多设备间的项目配置同步,团队协作更便捷
  • 应用实例管理: 支持创建多个独立的应用实例,满足不同项目需求

团队协作优化:

  • 多设备配置同步: 确保团队成员使用相同的项目配置
  • 统一项目管理: 避免配置不一致,提高团队协作效率
  • 智能冲突处理: 自动处理分支冲突,确保数据安全
  • 权限管理: 防止误操作,保护重要代码

开发体验提升:

  • 交互式界面: 直观的命令行界面,操作简单易用
  • 多语言支持: 支持中文、英文、日文、韩文、法文等多种语言
  • 智能提示: 降低使用门槛,提高开发效率
  • 环境变量管理: 自动设置系统环境变量,随时随地使用

安全可靠特性:

  • 自动备份: 配置自动备份,防止意外丢失
  • 版本控制: 内置版本管理,支持回滚操作
  • 数据保护: 智能冲突处理,确保代码安全
  • 扩展性强: 支持自定义配置,满足不同开发需求

FTP 文件传输工具 (mftp)

GitHub: https://github.com/liliangshan/mftp
功能: FTP 文件传输、目录管理、批量操作

🚀 智能 FTP 传输优势

智能文件同步:

  • 增量同步: 仅同步发生变更的文件,类似 Git 的增量更新机制
  • MD5 检测: 基于 MD5 快速检测文件变化,提高同步效率
  • 跨平台支持: 支持 Windows、macOS、Linux 多平台使用
  • 智能对比: 自动识别文件差异,避免不必要的传输

多语言国际化:

  • 全球支持: 支持简体中文、英文、繁体中文、日语、韩语、法语
  • 一键切换: 轻松切换语言,无语言障碍使用
  • 本地化体验: 完全本地化的用户界面和提示信息

简单易用设计:

  • 直观操作: 命令行界面操作直观,学习成本低
  • 快速配置: 快速配置 FTP 连接,支持交互式设置
  • 批量管理: 支持批量上传、下载、删除操作
  • 进度监控: 实时显示传输进度和状态

安全可靠保障:

  • 安全传输: 支持多种 FTP 服务器,确保传输安全
  • 详细日志: 完整的操作日志记录,便于问题排查
  • 错误处理: 智能错误处理和重试机制
  • 权限管理: 支持文件权限设置和修改

注意: 这些工具不是基于 MCP 协议的,它们是独立的命令行工具,可以与 MCP 工具集配合使用。


让 AI 辅助开发更加标准化和高效! 🚀

这套 MCP 工具集为现代 AI 辅助开发提供了完整的解决方案,从数据库管理到项目标准,从资源管理到团队协作,让您的开发工作更加高效、标准化和安全。

MCP Redis Server

A MCP Redis server with data operations, permission control and operation logs.

Features

  • ✅ Redis data operations (GET, SET, UPDATE, DELETE)
  • ✅ Key management (CREATE, DROP, EXISTS, INFO)
  • ✅ Dynamic tool list based on permissions
  • ✅ Operation logging
  • ✅ Connection management
  • ✅ Auto-reconnection mechanism
  • ✅ Health checks
  • ✅ Error handling and recovery

Installation

Global Installation (Recommended)

npm install -g @liangshanli/mcp-server-redis

Local Installation

npm install @liangshanli/mcp-server-redis

From Source

git clone https://github.com/liliangshan/mcp-server-redis.git
cd mcp-server-redis
npm install

Configuration

Set environment variables:

export HOST=localhost
export PORT=6379
export PASSWORD=your_password
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=true
export ALLOW_CREATE=true
export ALLOW_DROP=true

Usage

1. Direct Run (Global Installation)

mcp-server-redis

2. Using npx (Recommended)

npx @liangshanli/mcp-server-redis

3. Direct Start (Source Installation)

npm start

4. Managed Start (Recommended for Production)

npm run start-managed

Managed start provides:

  • Auto-restart (up to 10 times)
  • Error recovery
  • Process management
  • Logging

5. Development Mode

npm run dev

Editor Integration

Cursor Editor Configuration

  1. Create .cursor/mcp.json file in your project root:
{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-redis"],
      "env": {
        "HOST": "your_host",
        "PORT": "6379",
        "PASSWORD": "your_password",
        "ALLOW_INSERT": "true",
        "ALLOW_UPDATE": "true",
        "ALLOW_DELETE": "true",
        "ALLOW_CREATE": "true",
        "ALLOW_DROP": "true"
      }
    }
  }
}

VS Code Configuration

  1. Install the MCP extension for VS Code
  2. Create .vscode/settings.json file:
{
  "mcp.servers": {
    "redis": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-redis"],
      "env": {
        "HOST": "your_host",
        "PORT": "6379",
        "PASSWORD": "your_password",
        "ALLOW_INSERT": "true",
        "ALLOW_UPDATE": "true",
        "ALLOW_DELETE": "true",
        "ALLOW_CREATE": "true",
        "ALLOW_DROP": "true"
      }
    }
  }
}

As MCP Server

The server communicates with MCP clients via stdin/stdout after startup:

{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18"}}

Available Tools

  1. get_data: Get data by key

    {
      "jsonrpc": "2.0",
      "id": 2,
      "method": "tools/call",
      "params": {
        "name": "get_data",
        "arguments": {
          "key": "user:123"
        }
      }
    }
    
  2. set_data: Set/insert data for a key

    {
      "jsonrpc": "2.0",
      "id": 3,
      "method": "tools/call",
      "params": {
        "name": "set_data",
        "arguments": {
          "key": "user:123",
          "value": "John Doe",
          "ttl": 3600
        }
      }
    }
    
  3. list_keys: List Redis keys with pattern matching

    {
      "jsonrpc": "2.0",
      "id": 4,
      "method": "tools/call",
      "params": {
        "name": "list_keys",
        "arguments": {
          "pattern": "user:*",
          "limit": 10
        }
      }
    }
    

Dynamic Tool List

The server dynamically shows/hides tools based on environment variables:

Read-Only Tools (Always Available)

  • get_data - Get data by key
  • list_keys - List keys with pattern matching
  • exists_key - Check if key exists
  • get_key_info - Get key information
  • get_redis_info - Get Redis server information
  • get_database_stats - Get database statistics
  • get_memory_info - Get memory usage information
  • test_connection - Test Redis connection
  • get_operation_logs - Get operation logs
  • check_permissions - Check current permissions
  • set_ttl - Set time to live for a key
  • remove_ttl - Remove time to live from a key

Conditional Tools (Based on Permissions)

  • set_data - Requires ALLOW_INSERT=true
  • update_data - Requires ALLOW_UPDATE=true
  • delete_data - Requires ALLOW_DELETE=true
  • create_key - Requires ALLOW_CREATE=true
  • drop_key - Requires ALLOW_DROP=true
  • rename_key - Requires ALLOW_CREATE=true AND ALLOW_DROP=true

Connection Management Features

  • Auto-creation: Automatically creates Redis connection on notifications/initialized
  • Health checks: Checks connection status every 5 minutes
  • Auto-reconnection: Automatically reconnects when connection fails
  • Connection reuse: Uses connection pool for better performance
  • Graceful shutdown: Properly closes connections when server shuts down

Logging

Log file location: ./logs/mcp-redis.log

Logged content:

  • All requests and responses
  • Redis operation records
  • Error messages
  • Connection status changes

Error Handling

  • Individual request errors don’t affect the entire server
  • Connection errors are automatically recovered
  • Process exceptions are automatically restarted (managed mode)

Environment Variables

Variable Default Description
HOST localhost Redis host address
PORT 6379 Redis port
PASSWORD Redis password
ALLOW_INSERT true Whether to allow insert operations. Set to ‘false’ to disable
ALLOW_UPDATE true Whether to allow update operations. Set to ‘false’ to disable
ALLOW_DELETE true Whether to allow delete operations. Set to ‘false’ to disable
ALLOW_CREATE true Whether to allow create key operations. Set to ‘false’ to disable
ALLOW_DROP true Whether to allow drop/delete key operations. Set to ‘false’ to disable
MCP_LOG_DIR ./logs Log directory
MCP_LOG_FILE mcp-redis.log Log filename

Development

Project Structure

mcp-server-redis/
├── src/
│   ├── server-final.js        # Main server file
│   └── utils/                 # Utility modules
├── bin/
│   └── cli.js                 # CLI entry point
├── start-server.js            # Managed startup script
├── package.json
└── README.md

Testing

npm test

Quick Start

1. Install Package

npm install -g @liangshanli/mcp-server-redis

2. Configure Environment Variables

export HOST=localhost
export PORT=6379
export PASSWORD=your_password
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=true
export ALLOW_CREATE=true
export ALLOW_DROP=true

Permission Control Examples:

# Default: Enable all operations
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=true
export ALLOW_CREATE=true
export ALLOW_DROP=true

# Read-only mode (safe mode)
export ALLOW_INSERT=false
export ALLOW_UPDATE=false
export ALLOW_DELETE=false
export ALLOW_CREATE=false
export ALLOW_DROP=false

# Allow insert and update, but disable delete operations
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=false
export ALLOW_CREATE=true
export ALLOW_DROP=false

# Allow everything except DROP operations
export ALLOW_INSERT=true
export ALLOW_UPDATE=true
export ALLOW_DELETE=true
export ALLOW_CREATE=true
export ALLOW_DROP=false

3. Run Server

mcp-server-redis

License

MIT

Logo

更多推荐