oracle/mcp

Oracle MCP Server 存储库

定义

• Model Context Protocol (MCP) 服务器的参考实现集合。每个服务器位于 src/ 下，并使用不同的语言（Python、Node.js、Java 等）编写，以展示 MCP 的语言无关设计。

MCP 的功能

• MCP 是一种协议，用于标准化工具、数据和模型在云资源之间的通信方式。MCP 服务器实现一组具体的 Oracle 云特定工具，并将其暴露给任何 MCP 兼容客户端（例如 Cline、Cursor、MCPHost）。

主要组件

• 多语言服务器 – 例如： oci-cloud-mcp-server (Python SDK)、 oci-api-mcp-server (OCI CLI 包装器)、 oci-javascript-mcp-server、 oracle-db-mcp-java-toolkit 等。
• 共享认证模块 – 处理基于 stdio 和基于 HTTP 的服务器的 OCI 凭据解析和 HTTP 令牌交换。
• 容器支持 – 一些服务器可以使用 Podman 构建和运行。
• 开发者工具 – 与 Model Context Protocol Inspector 集成以进行调试，以及基于 Moon 的 monorepo 工作流（proto、moon run …）。

典型工作流

1. 安装轻量级 Python 工具 uv 和所需的服务器（例如 uvx oracle.oci-cloud-mcp-server@latest）。
2. 配置 OCI 凭据（OCI CLI 配置文件或用于 HTTP 模式的 IAM 机密应用）。
3. 将服务器添加到 MCP 客户端的 JSON 配置中（Cline、Cursor、MCPHost 的示例）。
4. 通过 stdio 或 HTTP 服务运行服务器（可选在 Podman 容器内）。
5. 使用客户端（或 Inspector）通过统一的 MCP 接口调用 Oracle 云工具、模型或数据管道。

适用人群

• 需要从任何语言调用 Oracle Cloud 服务（计算、数据库、存储）的一致方式的 构建 AI/ML 管道的开发者。
• 希望在不编写自定义客户端的情况下通过 MCP 公开新的 Oracle 特定功能的 工具作者。
• 偏好参考实现而非从头构建协议栈的模型编排工作流原型设计的 研究人员。

快速开始

# 1. 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. 通过 uv 安装 Python 3.13
uv python install 3.13
# 3. (如果使用 OCI) 配置 OCI CLI 配置文件
oci session authenticate --region=us-phoenix-1 --tenancy-name=my-tenancy
# 4. 运行推荐的服务器
uvx oracle.oci-cloud-mcp-server@latest
# 5. 将最小 JSON 片段添加到您的 MCP 客户端配置中（替换 <profile_name>）

在容器中运行

podman run -e ORACLE_MCP_HOST=0.0.0.0 -e ORACLE_MCP_PORT=8888 \
  -e OCI_REGION=us-phoenix-1 -e IDCS_DOMAIN=… \
  -p 127.0.0.1:8888:8888 oracle.oci-cloud-mcp-server:latest

开发工作流

• 安装 proto（moonrepo.dev/docs/proto/install）。
• 使用 moon run <server>:test 运行测试，moon run <server>:build 构建发行版，moon run :lint :lock 进行仓库范围的 lint 和锁文件检查。
• 对于 Python 服务器，uv 会根据锁文件创建隔离的虚拟环境；对于 JavaScript 服务器，则使用 npm。

成熟度

• 明确为 概念验证 / 参考，不适用于生产环境。适合学习、原型设计和贡献。

许可证

• 存储库包含 LICENSE.txt 文件（README 中未列出确切许可证，但随源代码提供）。

---

总结：Oracle 的 MCP Server 存储库是一个多语言展示，展示了如何通过 Model Context Protocol 公开 Oracle Cloud 工具，让 AI/ML 开发者能够以统一、语言无关的方式与云资源交互。