Oracle EPM Cloud MCP Server
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: bas-mcp-server
📺 视频教程与完整文章
第 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可用工具
工具 | 功能 | EPM REST API |
| 测试连接,发现 API 版本 |
|
| 列出所有 EPM 应用程序 |
|
| 读取当前月份、年份、方案变量 |
|
| 执行计算脚本或业务规则 |
|
| 轮询作业是否完成或出错 |
|
| 按维度成员从多维数据集提取数据 |
|
| 更改替代变量的值 |
|
安装
有两种选择。选择适合您工作方式的一种。
选项 A:一键安装(推荐)
适用于 v2.0.0 及更高版本。下载桌面扩展程序,安装即可。无需编辑路径,无需 JSON 配置文件。
从最新版本下载
oracle-epm-cloud-2.0.0.mcpb。打开 Claude Desktop。转到 设置 → 扩展 → 高级 → 安装扩展。
选择
.mcpb文件。完成。模拟模式开箱即用。测试时无需 Oracle 凭据。
对于实时模式(真实的 EPM 环境),请通过 Claude Desktop 的扩展设置配置您的环境变量。
选项 B:手动安装(面向开发者)
如果您想阅读或修改代码,请使用此选项。
先决条件
需要视频演示? 观看 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 智能体自动执行月度结账的流程:
检查当前期间:
get_substitution_variables查看 CurrMonth = "Mar"运行聚合: 使用 "Agg_AllData" 运行
run_business_rule等待完成: 使用返回的作业 ID 运行
check_job_status验证数据: 针对收入、销货成本、净收入运行
export_data_slice推进期间: 将 CurrMonth 从 "Mar" 更新为 "Apr" (
update_substitution_variable)确认:
get_substitution_variables验证 CurrMonth = "Apr"
这与财务团队每月手动执行的工作流程相同。现在可以通过自然语言执行。
故障排除
错误 | 原因 | 修复 |
Claude 中未显示 MCP 工具 | 配置路径错误 | 检查 |
401 未经授权 | 用户名格式 | 使用 |
403 禁止访问 | 权限不足 | 用户需要 EPM 管理员或适当的角色 |
连接被拒绝 | URL 错误 | 检查 |
ETIMEDOUT | 网络/防火墙 | 验证您是否可以从您的机器访问 EPM URL |
下一步计划
OAuth 2.0 支持:适用于启用了 MFA 的环境
FCCS 特定工具:合并、内部交易抵销
数据集成工具:通过迁移 API 上传和下载文件
Groovy 规则执行:通过 REST API 运行 Groovy 脚本
关于
此服务器是关于将 AI 智能体连接到 Oracle EPM Cloud 的系列文章的一部分。获取更多 Oracle EPM 内容、教程和工具:
所有见解和文章: fmepm.com/insights
YouTube 频道: @fmepm
网站: fmepm.com
LinkedIn: Fred Mamadjanov
从事 Oracle EPM 工作并想讨论 AI 集成?预约咨询电话。
这不是 Oracle 产品。Oracle EPM Cloud 是 Oracle Corporation 的商标。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Claude, connected to your own Oracle EPM. Each person as themselves, every call checked and logged.
Give AI agents 30,000+ safe, token-optimized actions across Workday, SAP, Oracle + hundreds more.
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
Related MCP Servers
- AlicenseCqualityFmaintenanceEnables interaction with Oracle EPM Cloud Financial Consolidation and Close (FCCS) through 25+ tools covering REST API operations including jobs, dimensions, journals, data management, reports, and consolidation tasks.36MIT
- AlicenseAqualityDmaintenanceEnables AI agents to interact with 1С:Enterprise and BAS ERP systems through REST and HTTP services, providing tools for searching catalogs, creating documents, and querying stock balances.6ISC
- AlicenseAqualityCmaintenanceEnables AI agents to explore Oracle Fusion Cloud schema metadata, run pre-built BI Publisher reports with bind parameters, and validate results against trusted ground truth.401Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI assistants to explore and report on Oracle-based ERP databases via read-only schema discovery, guarded ad-hoc SQL, and curated reports.5MIT