Oracle EPM Cloud MCP 服务器

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

由 Fred Mamadjanov 构建 — Oracle ACE，EPM 解决方案架构师 | fmepm.com

功能介绍

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

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

• “显示当前的替代变量”

• “运行 Agg_AllData 业务规则”

• “导出北美地区的 Q1 收入数据”

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

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

架构

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

可用工具

快速入门（模拟模式 — 无需 EPM 环境）

前置条件

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

• 已安装 Claude Desktop (下载)

第 1 步：下载并安装

# Clone or download this folder
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/index.js"]
    }
  }
}

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

Windows 示例：

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

Mac 示例：

{
  "mcpServers": {
    "oracle-epm-cloud": {
      "command": "node",
      "args": ["/Users/fred/oracle-epm-mcp-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/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 使用基本身份验证 (Basic Authentication)。您的用户名格式必须是 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. 验证数据： 针对收入、销货成本 (COGS)、净利润运行 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 内容、教程和工具，请访问：

• 视频演示：构建 Oracle EPM Cloud 的 AI 智能体

• 网站：fmepm.com

• YouTube：@fmepm

• LinkedIn：Fred Mamadjanov

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