mcp-oci

为 Oracle Cloud Infrastructure（OCI） 构建的 Model Context Protocol 服务器。它让支持 MCP 的客户端（Claude Desktop、Claude Code、Cursor、Copilot…）能够发现实时的 OCI 资源、梳理它们之间的关联关系，并生成可复现的 Terraform，而行为完全由各种标志（flags）控制。

可以把它看作你的云上的 Playwright-MCP：模型无需手动重建基础设施知识，只需直接问*“显示 prod compartment 中的所有 VCN”或“为这个 compartment 生成 Terraform”*，就能获得结构化、不含机密的答案。

功能特点

• 实时发现 — 通过 OCI Resource Search 发现 compartments、regions 以及任何其他资源。

• Terraform 生成 — 为已知类型（VCN、subnet、instance、bucket、compartment）生成准确、忠实的 HCL，为其余类型生成标注注释的骨架；还可以生成整个 compartment 的模块，并包含 provider 变量。

• 依赖关系图 — 节点/边（nodes/edges）以及建议的部署顺序（先依赖后）。

• 机密不触达模型 — 每个有效载荷（payload）在返回前都会经过脱敏处理。

• 安全开关 — 访问模式、compartment/region 白名单、预置门（provisioning gate）、dry-run 试运行以及 JSON 审计日志（见下文）。

• 标准认证 — 使用 OCI 配置文件（~/.oci/config）或实例主体（instance principals）。服务器不存储任何凭据。

Related MCP server: oci-mcp-server

安全模型

工具

发现（只读）：list_compartments、list_regions、search_resources、list_compartment_resources、get_resource

Terraform（只读）：generate_terraform、generate_compartment_terraform、build_dependency_graph

与 MCP 客户端一起使用

可与 Claude Code、Claude Desktop、Cursor、OpenAI Codex CLI、Windsurf、VS Code (Copilot) 以及任何其他 MCP 客户端配合使用——各客户端的配置方式参见 docs/CLIENTS.md。

安装

npm install
npm run build

配置

将服务器指向一个标准 OCI 配置文件。出于安全考虑，请使用一个 IAM 用户/策略，只对你希望 agent 访问的 compartments 授予只读（inspect/read）权限。

使用 Claude Desktop / Claude Code / Cursor 运行

{
  "mcpServers": {
    "oci": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-oci/dist/index.js"],
      "env": {
        "OCI_PROFILE": "DEFAULT",
        "OCI_MODE": "read-only",
        "OCI_COMPARTMENT_ALLOWLIST": "ocid1.compartment.oc1..xxxx",
        "OCI_REGION_ALLOWLIST": "us-ashburn-1"
      }
    }
  }
}

示例提示

• “列出所有 compartments，然后显示 prod compartment 中的所有资源。”

• “为 VCN ocid1.vcn.oc1..… 生成 Terraform。”

• “为 compartment … 构建一个依赖关系图，并告诉我部署顺序。”

开发

npm run dev        # watch mode
npm test           # security policy + terraform generation + graph + redaction
npm run typecheck

路线图

• 在 read-write/admin 与 OCI_ALLOW_APPLY 门控下执行 terraform plan / apply。

• 更多资源类型的映射器（load balancers、databases、DRGs、IAM policies）。

• 跨环境的配置漂移对比。

发布

该服务器随附一个 server.json 用于官方 MCP 注册表，并带一个 mcpName 用于 npm 所有权验证。参见 PUBLISHING.md 了解如何发布到 npm，并列示于 MCP 注册表、Smithery、Glama、Cursor 和 PulseMCP。

许可证

MIT