Oracle EPM Cloud MCP Server

FMEPM Connect Core

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

如需使用托管产品，请访问 FMEPM Connect。

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

如果这为你节省了时间，请为仓库点亮星标。星标能帮助其他 Oracle EPM 用户找到这项工作，也是我判断它是否有用的最明确依据。

---

在将其连接到真实系统之前

本演示仅展示一种可能的工作流。在将任何 AI 工具、大模型或 MCP 服务连接到 NSPB 或其他企业系统之前，组织应获得 IT、安全和合规团队的批准，并确保遵守内部数据治理和安全政策。

模拟模式可让你使用示例数据试用所有功能，无需凭据。请使用它。

---

功能说明

此 MCP 服务可让 AI Agent 与 Oracle EPM Cloud 交互。你无需手动运行 Postman 调用或 EPM Automate 命令，只需向 Claude 提出以下请求：

• “我的 EPM 环境中有哪些应用？”
• “显示当前的替代变量”
• “运行 Agg_AllData 业务规则”
• “导出北美地区 Q1 的收入数据”
• “将当前月份从 Mar 向前滚动到 Apr”

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

---

📺 视频教程和完整文章

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

• 在 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 Agent

---

架构

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

---

可用工具

工具	功能	EPM REST API
get_api_version	测试连接，发现 API 版本	GET /HyperionPlanning/rest/
list_applications	列出所有 EPM 应用	GET /HyperionPlanning/rest/v3/applications
get_substitution_variables	读取当前月份、年份和方案变量	GET .../substitutionvariables
run_business_rule	执行计算脚本或业务规则	POST .../jobs
check_job_status	查询作业是否已完成或出错	GET .../jobs/{jobId}
export_data_slice	按维度成员从多维数据集中提取数据	POST .../exportdataslice
update_substitution_variable	更改替代变量值	PUT .../substitutionvariables

---

安装

有两种方式。请选择适合你的方式。

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

v2.0.0 及更高版本提供此功能。下载桌面扩展并安装即可。无需编辑路径，也无需 JSON 配置文件。

当前发布的程序包仍显示旧产品名称。此源代码更改不会发布新程序包。

1. 从最新发布版本下载 oracle-epm-cloud-2.0.0.mcpb。
2. 打开 Claude Desktop。转到 Settings → Extensions → Advanced → Install Extension。
3. 选择 .mcpb 文件。
4. 完成。模拟模式开箱即用。测试时无需 Oracle 凭据。

如需使用实时模式（真实 EPM 环境），请通过 Claude Desktop 的扩展设置配置环境变量。

选项 B：手动安装（适用于开发者）

如果你想阅读或修改代码，请使用此方式。

前置条件

• 已安装 Node.js 24 LTS（推荐）或 Node.js 22 LTS（下载）
• 已安装 Claude Desktop（下载）

源代码包和扩展清单要求使用 Node.js 22 或更高版本。CI 会测试 Node.js 22 和 24；Node.js 18 和 20 已结束生命周期，不受支持。运行 npm ci 前，请使用 node --version 检查已安装的版本。

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

步骤 1：克隆并安装

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

步骤 2：配置 Claude Desktop

打开 Claude Desktop → Settings → Developer → Edit Config。

将以下内容添加到 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 环境）

在公司环境中进行此操作前，请阅读本页顶部的说明：务必先获得 IT、安全和合规团队的批准。

获得 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": "your_username",
        "EPM_PASSWORD": "your_password",
        "EPM_APP_NAME": "Vision"
      }
    }
  }
}

相同的 7 个工具，现在连接到你的真实环境。

身份验证说明

REST API 使用基本身份验证。输入用户名时，不要包含云帐户名称前缀。Oracle 将从 2026 年 11 月 20 日起，在生产环境的 26.11 版本中停止接受带前缀的格式。如果在已识别的 Pod 地址中检测到前缀与帐户名称匹配，我会发出警告，但绝不会改写它。

启用了多重身份验证（MFA）的帐户无法使用基本身份验证。你需要改用 OAuth 2.0，本版本不涵盖此内容。

---

月末结账自动化示例

以下是 AI Agent 自动执行月末结账时会遵循的步骤：

1. 检查当前期间： get_substitution_variables 查看 CurrMonth = "Mar"
2. 运行汇总： 使用 "Agg_AllData" 调用 run_business_rule
3. 等待完成： 使用返回的作业 ID 调用 check_job_status
4. 验证数据： 对 Revenue、COGS、Net Income 调用 export_data_slice
5. 推进期间： 使用 update_substitution_variable 将 CurrMonth 从 "Mar" 更新为 "Apr"
6. 确认： get_substitution_variables 验证 CurrMonth = "Apr"

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

---

故障排除

错误	原因	解决方法
Claude 中未显示 MCP 工具	配置路径错误	检查 claude_desktop_config.json 路径是否为绝对路径
401 Unauthorized	用户名格式	输入用户名时，不要包含云帐户名称前缀
403 Forbidden	权限不足	用户需要 EPM 管理员权限或适当的角色
Connection refused	URL 错误	检查 EPM_BASE_URL 是否与环境匹配
ETIMEDOUT	网络/防火墙	确认你的机器可以访问 EPM URL

---

后续计划

• 支持 OAuth 2.0，适用于启用了 MFA 的环境
• FCCS 专用工具： 合并、公司间抵销
• 数据集成工具： 通过 Migration API 上传和下载文件
• Groovy 规则执行： 通过 REST API 运行 Groovy 脚本

---

关于

此服务是持续推出的系列内容之一，旨在介绍如何将 AI Agent 连接到 Oracle EPM Cloud。了解更多 Oracle EPM 内容、教程和工具：

• 概览文章： 如何将 Claude AI 连接到 Oracle EPM Cloud
• 设置教程： 如何逐步为 Oracle EPM Cloud 设置 AI Agent
• 所有见解和文章： fmepm.com/insights
• YouTube 频道： @fmepm
• 网站： fmepm.com
• LinkedIn： Fred Mamadjanov

正在使用 Oracle EPM，并想讨论 AI 集成？预约探索电话。

---

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