MCP Server Oci

这是一个用于Oracle云基础设施的MCP服务器项目，允许LLM直接管理OCI资源，支持动态配置文件切换、计算实例和数据库系统管理等功能

云平台开发者工具 #云基础设施 #资源管理 #多租户支持 .Python

评分 : 2分

下载量 : 6.5K

更新时间 : 2025-10-09

打开站点

什么是OCI MCP服务器？

OCI MCP服务器是一个智能桥梁，让您能够通过自然语言对话来管理Oracle云基础设施。就像拥有一个云管理助手，您可以用简单的对话命令来启动服务器、管理数据库，而无需登录复杂的云控制台或记忆繁琐的命令。

如何使用OCI MCP服务器？

使用非常简单：首先配置好OCI账户，然后在Claude Desktop中启用此服务器，之后您就可以直接用自然语言与Claude对话来管理云资源。比如告诉Claude'请列出我的所有云服务器'或'启动生产环境的数据库'。

适用场景

适合开发团队、运维人员、技术管理者等需要频繁操作云资源的用户。特别适合需要快速响应业务需求、进行日常运维监控、或者在不同云环境间切换管理的场景。

主要功能

多账户动态切换

无需重启即可在不同Oracle云账户间切换，轻松管理多个项目或环境

云服务器管理

查看、启动、停止虚拟服务器实例，全面掌控计算资源

数据库系统管理

管理Oracle数据库系统的启动、停止、重启等完整生命周期操作

自然语言操作

使用简单的对话命令替代复杂的云控制台操作，降低技术门槛

实时状态监控

随时查看云资源和数据库的当前运行状态，及时掌握系统健康度

优势

操作简单：用对话替代复杂的技术操作

效率提升：快速执行日常运维任务

多环境支持：轻松切换不同云账户

实时响应：即时获取云资源状态

降低门槛：非技术人员也能管理云资源

局限性

需要预先配置OCI账户权限

依赖Claude Desktop环境

部分高级功能仍需使用OCI控制台

网络连接稳定性影响操作响应

如何使用

环境准备

确保已安装Python 3.10或更高版本，并已完成OCI CLI的基本配置

安装依赖

安装必要的Python包和MCP服务器组件

配置Claude Desktop

在Claude Desktop配置文件中添加MCP服务器设置

开始使用

重启Claude Desktop，现在您可以通过对话来管理OCI资源了

使用案例

日常运维检查

每天早上快速检查所有云资源的运行状态

环境切换管理

在开发、测试、生产环境间快速切换

紧急故障处理

快速响应服务器或数据库异常

资源清单管理

定期整理和查看云资源使用情况

常见问题

我需要有技术背景才能使用这个工具吗？

这个工具安全吗？会泄露我的云账户信息吗？

支持哪些类型的Oracle云资源管理？

如果操作出错怎么办？工具会自动回滚吗？

我可以在团队中共享这个配置吗？

🚀 适用于甲骨文云基础设施 (OCI) 的MCP服务器

本项目为甲骨文云基础设施实现了一个模型上下文协议 (MCP) 服务器，允许像Claude这样的大语言模型直接与OCI资源进行交互。

🚀 快速开始

本项目实现的MCP服务器能让大语言模型与OCI资源交互，以下为使用前的准备及启动方式。

✨ 主要特性

动态配置文件选择：无需重启服务器即可在OCI配置文件/租户之间进行切换。
使用标准OCI CLI配置连接到甲骨文云：借助标准的OCI CLI配置实现与甲骨文云的连接。
全面的OCI资源管理工具：具备用于列出和管理OCI资源的综合工具。
实例生命周期管理：可对实例进行启动、停止等操作。
数据库系统和数据库节点管理：支持对数据库系统和数据库节点进行管理。
与MCP协议集成：便于从Claude桌面端进行访问。

📦 安装指南

前提条件

Python 3.10 或更高版本。
已配置OCI CLI（oci setup config）。
在甲骨文云中具有适当的权限。

安装步骤

克隆此仓库：

pip install git+https://github.com/modelcontextprotocol/python-sdk.git
pip install oci fastapi uvicorn click pydantic loguru
pip install -e .

💻 使用示例

启动服务器

基础用法

选项1：动态配置文件选择（推荐） 不指定配置文件启动服务器，然后在运行时选择：

python -m mcp_server_oci.mcp_server

然后使用MCP工具管理配置文件：

list_oci_profiles - 查看 ~/.oci/config 中可用的配置文件。
set_oci_profile - 激活特定的配置文件。
get_current_oci_profile - 检查当前激活的配置文件。

选项2：使用默认配置文件 预先加载特定的配置文件启动：

python -m mcp_server_oci.mcp_server --profile DEFAULT

使用 uv 启动：

uv --directory /path/to/mcp-server-oci run python -m mcp_server_oci.mcp_server --profile DEFAULT

高级用法

在租户之间切换

无需重启服务器即可在不同的OCI租户之间进行切换：

# 在你的MCP客户端（例如Claude）中：
# 1. 列出可用的配置文件
"Show me available OCI profiles"

# 2. 切换到不同的租户
"Switch to the 'production' OCI profile"

# 3. 验证当前的配置文件
"What OCI profile am I using?"

为Claude桌面端（MacOS）进行配置

将以下配置添加到文件 /Users/<usuario>/Library/Application Support/Claude/claude_desktop_config.json 中：

使用动态配置文件选择（推荐）：

"mcpServers": {
  "mcp-server-oci": {
    "command": "python",
    "args": [
      "-m",
      "mcp_server_oci.mcp_server"
    ],
    "env": {
      "PYTHONPATH": "/<PATH_TO_MCP>/mcp-server-oci",
      "FASTMCP_LOG_LEVEL": "INFO"
    }
  }
}

使用固定配置文件：

"mcpServers": {
  "mcp-server-oci": {
    "command": "python",
    "args": [
      "-m",
      "mcp_server_oci.mcp_server",
      "--profile", "DEFAULT"
    ],
    "env": {
      "PYTHONPATH": "/<PATH_TO_MCP>/mcp-server-oci",
      "FASTMCP_LOG_LEVEL": "INFO"
    }
  }
}

使用 uv 和动态配置文件：

"mcpServers": {
  "mcp-server-oci": {
    "command": "uv",
    "args": [
      "--directory",
      "/<PATH_TO_MCP>/mcp-server-oci",
      "run",
      "python",
      "-m",
      "mcp_server_oci.mcp_server"
    ],
    "env": {
      "FASTMCP_LOG_LEVEL": "INFO"
    }
  }
}