oracle-cloud

oracle-cloud-mcp

[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!Node.js](https://nodejs.org)

用于 Oracle Cloud Infrastructure（OCI）的 MCP 服务。通过官方 OCI SDK 提供对 Compute、Object Storage、Block Storage、Networking、Autonomous Database 和 IAM 的访问。

工具（共 23 个）

Compute（4 个工具）

工具	描述
oci_compute_list_instances	列出 compartment 中的所有 VM 实例
oci_compute_get_instance	获取特定实例的详细信息
oci_compute_list_shapes	列出可用的 shape（包括 Always Free）
oci_compute_instance_action	对实例执行 START、STOP、RESET、SOFTSTOP 或 SOFTRESET

Object Storage（5 个工具）

工具	描述
oci_os_get_namespace	获取 Object Storage 命名空间
oci_os_list_buckets	列出 compartment 中的所有存储桶
oci_os_create_bucket	创建新的存储桶（Standard 或 Archive）
oci_os_list_objects	列出对象，可选按前缀筛选
oci_os_delete_bucket	删除空存储桶

Block Storage（2 个工具）

工具	描述
oci_bv_list_volumes	列出块存储卷
oci_bv_list_boot_volumes	列出可用性域中的启动卷

Networking（3 个工具）

工具	描述
oci_vcn_list	列出 Virtual Cloud Networks
oci_subnet_list	列出 VCN 中的子网
oci_vcn_create	使用 CIDR 块创建新的 VCN

Autonomous Database（4 个工具）

工具	描述
oci_adb_list	列出 Autonomous Database（ATP/ADW）
oci_adb_get	获取数据库详细信息和连接字符串
oci_adb_start	启动已停止的数据库
oci_adb_stop	停止正在运行的数据库

IAM（5 个工具）

工具	描述
oci_iam_list_users	列出 IAM 用户
oci_iam_list_groups	列出 IAM 组
oci_iam_list_policies	列出 IAM 策略和声明
oci_iam_list_compartments	列出租户中的 compartment
oci_iam_list_availability_domains	列出可用性域

安装

npm install

配置

在 ~/.oci/config 中配置 OCI 凭据：

[DEFAULT]
user=ocid1.user.oc1..xxx
fingerprint=xx:xx:xx:xx:xx
tenancy=ocid1.tenancy.oc1..xxx
region=us-chicago-1
key_file=~/.oci/api_keys/oci_api_key.pem

添加到 Claude Code MCP 配置中：

{
  "mcpServers": {
    "oracle": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/oracle-mcp/index.js"],
      "env": {
        "OCI_CONFIG_FILE": "~/.oci/config",
        "OCI_PROFILE": "DEFAULT",
        "OCI_REGION": "us-chicago-1"
      }
    }
  }
}

环境变量

变量	描述	必需
OCI_CONFIG_FILE	OCI 配置文件的路径	否（默认值为 ~/.oci/config）
OCI_PROFILE	配置配置文件名称	否（默认值为 DEFAULT）
OCI_TENANCY_OCID	租户 OCID	否（从配置中读取）
OCI_REGION	OCI 区域	否（默认值为 us-chicago-1）

身份验证

支持两种方式：

1. 会话令牌 -- 使用配置中的 security_token_file（推荐用于交互式使用）
2. API 密钥 -- 使用带指纹的 RSA 密钥对（用于自动化）

Oracle Cloud 免费套餐

资源	免费额度
Compute（Ampere A1）	4 个 OCPU，24 GB RAM
Compute（AMD E2.1.Micro）	2 个实例
Object Storage	20 GB Standard + 20 GB Archive
Block Storage	总计 200 GB
Autonomous Database	2 个 Always Free 数据库
出站数据	10 TB/月

依赖项

• @modelcontextprotocol/sdk -- MCP 协议 SDK
• oci-sdk -- Oracle Cloud 官方 Node.js SDK

许可证

MIT