mcp-oci

用途

mcp-oci 是一个面向 Oracle Cloud Infrastructure（OCI）的 Model Context Protocol（MCP）服务器。它让具备 MCP 能力的客户端（Claude Desktop、Claude Code、Cursor、Copilot 等）能够发现实时 OCI 资源、映射资源之间的关系，并生成可复现的 Terraform 配置，而行为完全由标志位控制。官方将其类比为面向云环境的 Playwright-MCP：模型不必手工重建基础设施知识，而是可以直接询问“显示 prod compartment 中所有 VCN”和“为该 compartment 生成 Terraform”，并获得结构化、无密钥的答案。

主要能力

• 实时发现：支持 compartments、区域，以及通过 OCI Resource Search 搜索任意资源。
• Terraform 生成：为已知类型（VCN、子网、实例、存储桶、compartment）生成忠实的 HCL；其他类型生成带注释的骨架；支持带 provider 变量的整个 compartment 模块。
• 依赖图：提供节点/边，以及建议的配置顺序（依赖优先）。
• 密钥不外泄：所有返回给模型的数据在返回前均已脱敏，密钥不会到达模型。
• 安全标志：访问模式、compartment/区域白名单、配置门禁、dry-run 和 JSON 审计日志。
• 标准认证：支持 OCI 配置文件（~/.oci/config）或实例主体认证；服务器不存储凭据。

工具列表

发现（只读）：

• list_compartments
• list_regions
• search_resources
• list_compartment_resources
• get_resource

Terraform（只读）：

• generate_terraform
• generate_compartment_terraform
• build_dependency_graph

使用方式

已发布到 npm，包名为 @dockndevai/mcp-oci，无需克隆或构建——MCP 客户端通过 npx 按需运行。建议从只读模式开始；.env.example 列出了全部变量，docs/CLIENTS.md 提供完整的各客户端指南。

各客户端的配置方式（在对应配置文件中加入相同配置块）：

• Claude Code（CLI）
• Claude Desktop、Cursor、Windsurf：在 claude_desktop_config.json、.cursor/mcp.json 或 ~/.codeium/windsurf/mcp_config.json 中加入相同配置块
• OpenAI Codex CLI：在 ~/.codex/config.toml 中配置
• VS Code（GitHub Copilot，Agent 模式）：在 .vscode/mcp.json 中配置

将其指向标准的 OCI 配置 profile。出于安全考虑，建议使用对目标 compartment 仅具备只读（inspect/read）权限的 IAM 用户/策略。

从源码运行（开发用途）：优先使用上述已发布包。若要从克隆版本运行，可参考仓库说明。

示例提示词

• “列出所有 compartments，然后显示 prod compartment 中的每一个资源。”
• “为 VCN ocid1.vcn.oc1..… 生成 Terraform。”
• “为 compartment … 构建依赖图，并告诉我配置顺序。”

路线图（根据官方说明）

• 在 read-write/admin 模式及 OCI_ALLOW_APPLY 下执行 terraform plan/apply。
• 更多资源类型映射器（负载均衡器、数据库、DRG、IAM 策略）。
• 跨环境漂移比较。

发布信息

该服务器提供用于官方 MCP registry 的 server.json，以及用于 npm 所有权验证的 mcpName。PUBLISHING.md 说明了如何发布到 npm 并上架 MCP registry、Smithery、Glama、Cursor 和 PulseMCP。

限制

资料中未提供具体的收费、价格、运行环境要求、性能数据或最终用户协议信息；其余未提及的功能、平台或效果暂未提供。