AI导哈

密钥管理服务器

Oracle OCI Vault MCP Server是一款为AI助手和代码编辑器提供安全访问Oracle Cloud Infrastructure Vault密钥的MCP服务器，支持密钥的创建、检索、更新和删除操作。

  • by acedergren
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 acedergren/oracle-oci-vault-mcp-server

使用说明

Oracle OCI保险库MCP服务器

MCP（模型上下文协议）服务器，为AI助手和代码编辑器提供对Oracle云基础设施保险库机密的安全、直接访问。通过Claude、Cursor、OpenCode和任何兼容MCP的客户端管理、检索和旋转机密。

✨ 特性

  • 🔐 完整的秘密管理 -OCI Vault机密的完整CRUD操作
  • 🔄 版本控制 -通过回滚支持访问和管理所有机密版本
  • 🏢 企业级就绪 -基于Oracle云基础架构，集成IAM
  • 🤖 通用AI集成 -适用于Claude、Cursor、OpenCode和任何MCP客户端
  • 📋 元数据 -查看创建日期、轮换状态、生命周期阶段等
  • 🔍 智能搜索 -通过模式匹配和过滤查找秘密
  • ⚡ 快速可靠 -通过连接池优化性能
  • 🛡️ 安全已验证 -零发现的Semgrep审计

🚀 快速开始

1.安装

pip install oci-vault-mcp-server

或者直接使用，无需安装：

uvx oci-vault-mcp-server

2.配置OCI

oci setup config

3.选择您的IDE

选择您最喜欢的并按照设置指南进行操作：

IDE 安装 安装链接
VS代码+临床 指南 安装Cline
克劳德桌面 指南 下载克劳德
光标IDE 指南 下载光标
开源代码 指南 访问OpenCode
任何MCP客户端 指南 —

4.开始使用

Ask your AI: "Can you list all secrets in my OCI Vault?"

📦 安装方法

PyPI包（推荐）

pip install oci-vault-mcp-server

直接执行（无需安装）

uvx oci-vault-mcp-server

Docker容器

docker pull oracle/oci-vault-mcp-server:latest

docker run -v ~/.oci:/root/.oci \
  -e OCI_CLI_PROFILE=default \
  oracle/oci-vault-mcp-server:latest

来自源头

git clone https://github.com/acedergren/oracle-oci-vault-mcp-server.git
cd oracle-oci-vault-mcp-server
pip install -e .

🛠️ 可用工具

MCP服务器提供12个全面的工具，用于完整的秘密生命周期管理：

工具 目的 示例
list_secrets 列出vault中的所有机密 列出所有150个机密
search_secrets 按名称模式搜索 查找所有“prod-*”秘密
get_secret 获取完整的秘密对象 检索秘密元数据
get_secret_value 获取当前机密值 检索API密钥值
get_secret_metadata 查看元数据和生命周期 检查轮换状态
list_secret_versions 显示所有版本 查看版本历史记录
create_secret 创建新机密 添加新的API密钥
update_secret 更新机密值 旋转密码
update_secret_metadata 修改元数据 更新描述
delete_secret 计划删除 删除已弃用的机密
configure_vault 设置保险库配置 更改隔间
get_vault_config_tool 查看当前配置 检查活动vault

📚 文档

入门指南

IDE特定指南

  • VS代码+临床 -与Cline扩展完全集成VS代码
    • 包括直接安装链接
    • 键盘快捷键和工作流程
    • 高级调试设置
  • 克劳德桌面 -macOS、Windows、Linux的设置
    • 环境变量配置
    • Docker和本地安装
    • 性能调优
  • 光标IDE -现代Cursor IDE设置
    • 5分钟快速启动
    • 多环境配置
    • 自定义快捷方式
  • 开源代码 -自定义斜线命令
    • /保险库列表机密
    • /保险库获得秘密
    • /保险库创建秘密
    • 还有更多。..

参考文件

💡 用法示例

列出所有秘密

User: "List all secrets in my OCI Vault"

AI: I'll retrieve all secrets from your vault...
[Shows all secrets with creation date and version info]

创建和管理秘密

User: "Create a new secret called 'api-key' with this value: sk_live_xxx"

AI: I'll create that secret and show you how to use it...
[Creates secret and provides integration examples]

按模式搜索秘密

User: "Find all secrets that start with 'prod-'"

AI: Searching for production secrets...
[Shows matching secrets with metadata]

查看机密元数据

User: "Show me the metadata for the database-password secret"

AI: Here's the complete metadata...
[Shows creation date, versions, lifecycle stage, etc.]

旋转秘密

User: "I need to rotate the database password. Show me the current version."

AI: Here's the version history...
[Shows all versions and helps create new one]

🔐 安全

  • ✅ 无硬编码凭据 -使用OCI CLI或环境变量
  • ✅ IAM集成 -与OCI身份和访问管理配合使用
  • ✅ 审计日志 -OCI审计日志中记录的所有操作
  • ✅ 零漏洞 -Semgrep安全审计，未发现任何问题
  • ✅ 传输中的加密 -用于所有OCI API调用的HTTPS
  • ✅ 静态加密 -OCI Vault处理秘密加密

最佳实践

  1. 使用OCI配置文件 -为不同的环境创建单独的配置文件

    oci setup config --profile production
oci setup config --profile development

  2. 限制IAM权限 -授予所需的最小权限

    SECRETSFAMILY_READ
SECRETSFAMILY_UPDATE (if managing secrets)

  3. 旋转凭据 -定期更新API密钥

    oci iam user api-key-list
oci iam user api-key-delete

  4. 启用审核日志记录 -监控所有保险库访问

    oci audit event list --compartment-id <id>

  5. 使用隔间 -按隔间整理秘密

🛠️ 先决条件

  • Python 3.13+ -服务器需要
  • OCI-CLI -配置为 oci setup config
  • OCI账户 -具有Vault服务访问权限
  • 有效凭证 -API密钥或会话令牌

安装OCI CLI

# macOS
brew install oci-cli

# Ubuntu/Debian
apt-get install oci-cli

# Or visit: https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm

🐛 故障排除

“未找到OCI CLI”

oci setup config

vault操作的“权限被拒绝”

在OCI控制台中检查IAM权限：

  • 用户必须拥有 SECRETSFAMILY_READ 许可
  • 或更广泛 SECRETSFAMILY_MANAGE_ALL 完全访问

“MCP服务器没有响应”

  1. 验证服务器是否正在运行： ps aux | grep oci-vault-mcp
  2. 检查OCI凭据： oci vault secret list --compartment-id <id>
  3. 重新启动IDE/客户端

更多帮助

看 故障排除指南 30多个常见问题

🤝 贡献

我们欢迎捐款！请看 贡献.md 作为指导方针。

📄 许可证

根据通用许可证（UPL）1.0许可。 看 LICENSE.txt 了解详情。

📞 支持

🔗 相关资源

🎯 路线图

  • []支持OCI KMS（密钥管理服务）
  • []批量秘密管理的批量操作
  • []秘密加密/解密实用程序
  • []与CI/CD管道集成
  • []指标和监控仪表板
  • []用于秘密管理的Web UI

📊 项目统计

  • 12 全面秘密管理工具
  • 16 文档文件
  • 2,771+ 文件行
  • 4 IDE设置指南
  • 30+ 故障排除解决方案
  • 0 安全漏洞（Semgrep验证）

🙏 致谢

使用FastMCP 2.14.2和Oracle云基础架构SDK构建。

需要帮助？ 从...开始 客户端安装中心 选择您的IDE。

有问题吗？ 检查 故障排除指南 或打开 问题.

想贡献吗？ 看 贡献.md 作为指导方针。

最后更新：2025年1月| 版本: 1.0

相关 MCP