Oracle EPM Cloud MCP 服务器

通过 REST API 将 Claude AI（或任何兼容 MCP 的客户端）连接到 Oracle EPM Cloud。

由 Oracle ACE 和 EPM 解决方案架构师 Fred Mamadjanov 构建。更多信息请访问 fmepm.com。

如果这为您节省了时间，请为仓库加星。加星是其他 Oracle EPM 同行发现此项目的方式，也是我判断其是否有用的最直接信号。

此工具的功能

此 MCP 服务器使 AI 智能体能够与 Oracle EPM Cloud 进行交互。无需手动运行 Postman 调用或 EPM Automate 命令，您可以要求 Claude 执行以下操作：

• “我的 EPM 环境中有哪些应用程序？”

• “向我展示当前的替代变量”

• “运行 Agg_AllData 业务规则”

• “导出北美第一季度的收入数据”

• “将当前月份从 3 月推进到 4 月”

该服务器将这些自然语言请求转换为 Oracle EPM REST API 调用。

Related MCP server: mcp-oraclefusion

📺 视频教程与完整文章

第 2 集：我是如何构建它的 使用 MCP 和 REST API 为 Oracle EPM Cloud 构建 AI 智能体。

• 在 YouTube 上观看：youtu.be/At4_ZIq2jBY

• fmepm.com 上的完整文章：如何将 Claude AI 连接到 Oracle EPM Cloud

第 3 集：如何设置（分步指南） 在 5 分钟内安装并配置此 MCP 服务器。

• 在 YouTube 上观看：youtu.be/kgUDAKARk7c

• fmepm.com 上的完整设置指南：如何为 Oracle EPM Cloud 设置 AI 智能体

架构

You (natural language) → Claude Desktop → MCP Protocol → This Server → Oracle EPM REST APIs → Your EPM Cloud

可用工具

安装

有两种选择。选择适合您工作方式的一种。

选项 A：一键安装（推荐）

适用于 v2.0.0 及更高版本。下载桌面扩展程序，安装即可。无需编辑路径，无需 JSON 配置文件。

1. 从最新版本下载 oracle-epm-cloud-2.0.0.mcpb。

2. 打开 Claude Desktop。转到 设置 → 扩展 → 高级 → 安装扩展。

3. 选择 .mcpb 文件。

4. 完成。模拟模式开箱即用。测试时无需 Oracle 凭据。

对于实时模式（真实的 EPM 环境），请通过 Claude Desktop 的扩展设置配置您的环境变量。

选项 B：手动安装（面向开发者）

如果您想阅读或修改代码，请使用此选项。

先决条件

• 已安装 Node.js 18+ (下载)

• 已安装 Claude Desktop (下载)

需要视频演示？ 观看 YouTube 上的第 3 集 或阅读 fmepm.com 上的分步指南。

第 1 步：克隆并安装

git clone https://github.com/fmepm/oracle-epm-mcp-server.git
cd oracle-epm-mcp-server
npm install

第 2 步：配置 Claude Desktop

打开 Claude Desktop → 设置 → 开发者 → 编辑配置。

将此内容添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/FULL/PATH/TO/oracle-epm-mcp-server/server/index.js"]
    }
  }
}

将 /FULL/PATH/TO/ 替换为您机器上的实际路径。

Windows 示例：

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["C:\\Users\\Fred\\oracle-epm-mcp-server\\server\\index.js"]
    }
  }
}

Mac 示例：

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/Users/fred/oracle-epm-mcp-server/server/index.js"]
    }
  }
}

第 3 步：重启 Claude Desktop

完全退出 Claude Desktop 并重新打开。您应该会在聊天输入区域看到 MCP 工具图标（锤子）。点击它以验证是否列出了 "oracle-epm-cloud"。

第 4 步：尝试一下

在 Claude Desktop 中输入：

“我的环境中可以使用哪些 EPM 应用程序？”

Claude 将使用 list_applications 工具并返回模拟数据。

切换到实时模式（真实的 EPM 环境）

当您可以访问 Oracle EPM Cloud 环境时，请在您的 Claude Desktop 配置中设置这些环境变量：

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/FULL/PATH/TO/oracle-epm-mcp-server/server/index.js"],
      "env": {
        "EPM_MODE": "live",
        "EPM_BASE_URL": "https://epm-YOURDOMAIN.epm.REGION.oraclecloud.com",
        "EPM_USERNAME": "IDENTITYDOMAIN.your_username",
        "EPM_PASSWORD": "your_password",
        "EPM_APP_NAME": "Vision"
      }
    }
  }
}

同样的 7 个工具，现在将连接到您的真实环境。

身份验证说明

REST API 使用基本身份验证。您的用户名格式必须是 identitydomain.username。这是最常见的错误。如果您收到 401 错误，请首先检查这一点。

启用了多因素身份验证 (MFA) 的账户无法使用基本身份验证。您需要改用 OAuth 2.0，此版本暂不支持。

月度结账自动化示例

以下是 AI 智能体自动执行月度结账的流程：

1. 检查当前期间： get_substitution_variables 查看 CurrMonth = "Mar"

2. 运行聚合： 使用 "Agg_AllData" 运行 run_business_rule

3. 等待完成： 使用返回的作业 ID 运行 check_job_status

4. 验证数据： 针对收入、销货成本、净收入运行 export_data_slice

5. 推进期间： 将 CurrMonth 从 "Mar" 更新为 "Apr" (update_substitution_variable)

6. 确认： get_substitution_variables 验证 CurrMonth = "Apr"

这与财务团队每月手动执行的工作流程相同。现在可以通过自然语言执行。

故障排除

下一步计划

• OAuth 2.0 支持：适用于启用了 MFA 的环境

• FCCS 特定工具：合并、内部交易抵销

• 数据集成工具：通过迁移 API 上传和下载文件

• Groovy 规则执行：通过 REST API 运行 Groovy 脚本

关于

此服务器是关于将 AI 智能体连接到 Oracle EPM Cloud 的系列文章的一部分。获取更多 Oracle EPM 内容、教程和工具：

• 概述文章： 如何将 Claude AI 连接到 Oracle EPM Cloud

• 设置教程： 如何为 Oracle EPM Cloud 设置 AI 智能体，分步指南

• 所有见解和文章： fmepm.com/insights

• YouTube 频道： @fmepm

• 网站： fmepm.com

• LinkedIn： Fred Mamadjanov

从事 Oracle EPM 工作并想讨论 AI 集成？预约咨询电话。

这不是 Oracle 产品。Oracle EPM Cloud 是 Oracle Corporation 的商标。