ofrag — MCP Server for Oracle Fusion Cloud
Give your AI agent direct access to Oracle Fusion ERP data. Ask questions in plain English — get SQL results in seconds.
Demo · What is it · Tools · Quick Start · Docs
______________________________________________________________________
问题
Oracle Fusion Cloud已经 25000多张桌子 横跨财务、供应链管理、HCM和采购。查找正确的表、理解连接关系和编写正确的SQL需要花费数小时在Oracle文档中挖掘。即使是经验丰富的顾问，每个查询周期也要花费15分钟以上的时间：登录BI Publisher→ 创建数据模型→ 写SQL→ 调试→ 重新运行。
ofrag完全消除了这一点。 您的AI代理在语义上发现表，根据本地模式缓存验证SQL，并对实时Fusion数据执行查询——所有这些都在一次对话中完成。
✨ 神奇的时刻
你： “显示上个月供应商Acme Corp的前5张未付发票。” 克劳德+拉格： 1. 发现 通过语义搜索找到正确的表(AP_INVOICES_ALL,POZ_SUPPLIERS,HZ_PARTIES) 1. 理解 “未付”是指PAYMENT_STATUS_FLAG = 'N'1. 验证 针对本地元数据的SQL——在错误投入生产之前捕获错误 1. 执行 对实时Oracle Fusion实例的查询 1. 退货 包含发票编号、金额和日期的格式化表格 总时间：~4秒。
没有BI发布者。没有数据模型。没有OTBI主题领域。只是一个问题和一个答案。
🧠 什么是抹布
ofrag是一个 MCP（模型上下文协议）服务器 --一个允许AI代理使用外部工具的开放标准。它允许Claude、OpenAI、Gemini和任何兼容MCP的LLM结构化访问您的Oracle Fusion Cloud数据。
┌──────────────────────────────────────────────────────────────┐
│ Your AI Agent │
│ Claude · OpenAI · Gemini · Claude Code │
├──────────────────────────────────────────────────────────────┤
│ ofrag (MCP Server) │
│ │
│ ┌─────────────┐ ┌──────────────┐ ┌─────────────────────┐ │
│ │ Semantic │ │ SQL Linter │ │ Business Process │ │
│ │ Search │ │ (AST-based) │ │ Mapper │ │
│ └──────┬──────┘ └──────┬───────┘ └──────────┬──────────┘ │
│ │ │ │ │
│ ┌──────▼──────────────────────────────────────▼──────────┐ │
│ │ Local DuckDB Metadata Cache │ │
│ │ 25,000+ tables · 240K+ descriptions │ │
│ └────────────────────────┬───────────────────────────────┘ │
│ │ Only validated queries │
├───────────────────────────▼──────────────────────────────────┤
│ Oracle Fusion Cloud │
│ BI Publisher SOAP · REST APIs │
└──────────────────────────────────────────────────────────────┘关键原则： 所有模式探索都在本地进行——在发现过程中对生产环境没有查询。只有经过验证的最终SQL才能到达您的实时Fusion实例。
🔑 为什么抹布别无选择
| ofrag+AI代理 | 手动BI发布器 | OTBI | 专有SQL工具 | |
|---|---|---|---|---|
| 自然语言查询 | ✅ 用简单的英语提问 | ❌ 手动编写SQL | ❌ 仅限拖放 | ❌ 手动编写SQL |
| 架构发现 | ✅ 跨25K多个表的语义搜索 | ❌ 阅读Oracle文档 | ❌ 有限的主题领域 | ✅ 表格浏览器 |
| 执行前的SQL验证 | ✅ AST解析本地缓存 | ❌ 试错法 | 不适用 | ❌ |
| 跨模块表关系 | ✅ AI追踪AP→XLA→GL链 | ❌ 手动知识 | ❌ 单一主题领域 | ❌ |
| 业务流程映射 | ✅ business_process_map, scenario_mapper | ❌ | ❌ | ❌ |
| 多环境切换 | ✅ 一次会话中的DEV/SIT/UAT/PROD | ❌ 单独登录 | ❌ 单独登录 | 部分 |
| REST API访问 | ✅ 内置通用REST客户端 | ❌ | ❌ | ❌ |
| 安全生产 | ✅ 本地优先，仅验证查询 | ⚠️ 直接执行 | ✅ 沙盒 | ⚠️ 直接执行 |
真正的区别： 其他工具帮助您 *写* SQL。ofrag让你 *跳过* 编写SQL——AI使用经过验证的元数据正确地为您完成。
🛠 工具目录
抹布暴露 30+工具 按功能组织的AI代理：
发现和搜索
| 工具 | 它做什么 |
|---|---|
semantic_search | 使用跨24万+描述的向量嵌入，按业务含义（“未付发票”、“员工薪酬”）查找表/列 |
search_identifiers | 按Oracle名称模式查找表/列(AP_INVOICES, VENDOR_ID) |
search_descriptions | 表/列描述中的精确关键字搜索 |
list_tables | 使用过滤器按模块浏览表 |
list_columns | 获取表的所有列、类型和描述 |
index_info | 表的索引定义 |
table_overview | 快速摘要：列数、目的、模块 |
SQL和执行
| 工具 | 它做什么 |
|---|---|
execute_oracle_sql | 针对Oracle Fusion执行实时SQL，结果内联 |
execute_oracle_sql_to_file | 执行SQL，将结果保存到本地文件（适用于大型数据集） |
lint_sql | 将SQL解析为AST，根据缓存的模式进行验证——在执行前捕获错误 |
suggest_sql | 使用元数据缓存自动完成部分SQL |
raw_select | 直接查询本地DuckDB元数据缓存 |
商业智能
| 工具 | 它做什么 |
|---|---|
module_summary | Fusion模块概述——目的、关键表、典型查询 |
business_process_map | 将业务流程映射到其表、阶段和关键列 |
scenario_mapper | 将业务意图（“月末结算”）映射到推荐的表格和指标 |
relationship_map | 显示任何表的入站/出站JOIN关系 |
cross_module_analyzer | 分析表如何跨Fusion模块连接 |
integration_flow_mapper | 追踪端到端数据流：上游馈线→ 桌子→ 下游消费者 |
process_catalog | 包含所有阶段和表格的完整业务流程目录 |
REST API
| 工具 | 它做什么 |
|---|---|
rest_call | 对Oracle Fusion进行HTTP REST API调用，结果内联 |
rest_call_to_file | 将结果保存到文件的REST API调用 |
融合配置
| 工具 | 它做什么 |
|---|---|
describe_flexfield | 描述描述性柔性字段（DFF）——上下文、段、值集 |
lookup_values | 获取Fusion查找类型（LOV）的所有值 |
profile_values | 获取站点/产品/用户级别的配置文件选项值 |
BI出版商和ESS
| 工具 | 它做什么 |
|---|---|
run_bi_report | 执行包含参数和结果的BI Publisher报告 |
run_bi_report_to_file | 执行BI Publisher报告，将输出保存到文件 |
submit_ess_job | 提交ESS作业（批处理、导入、导出） |
get_ess_job_status | 检查ESS作业状态 |
环境管理
| 工具 | 它做什么 |
|---|---|
authenticate | 基于浏览器的Oracle Fusion单点登录 |
get_auth_status | 检查当前身份验证状态 |
add_environment | 添加/更新命名环境（DEV、SIT、UAT、PROD） |
switch_environment | 立即切换活动环境 |
list_environments | 列出所有已配置的环境 |
compare_environments | 比较两个环境之间的配置数据 |
🚀 快速开始
1.获取二进制文件
下载自 发布 （Windows和macOS）。
2.遵循设置指南
👉 安装与设置指南 --一步一步：许可、BI发布者报告部署、MCP客户端配置（Claude Desktop、Gemini、Claude Code）、身份验证设置。
3.开始与您的ERP对话
“哪些表存储AP发票数据？”\ “显示Acme Corp的所有逾期发票”\ “应付账款余额如何与总账挂钩？”\ “比较DEV和PROD之间的供应商数量”
💡 用例
临时数据分析 --询问“按业务部门显示第四季度的收入”，并在几秒钟内获得结果。无需创建OTBI报告，无需BI发布者数据模型，无需等待。
实施故障排除 -在Fusion实施过程中，快速验证数据：“是否有未分配的AP发票？”、“显示尚未从XLA转移的总账日记账分录”。
数据校正 --“将24年12月期间的应付账款明细账总额与总账余额进行比较”。AI追踪整个AP→ XLA → 总账链并识别差异。
模式探索 --“哪些表存储员工薪酬数据？”人工智能使用语义搜索来查找相关的HCM表，显示它们之间的关系，并解释数据模型。
一体化发展 --构建OIC集成？询问“AP发票存在哪些REST端点？”或“导入日记账的FBDI模板是什么？”——ofrag会找到它。
EBS → 聚变迁移 --“EBS中AP_INVOICES_ALL的Fusion等效物是什么？”AI使用语义搜索和模块知识将EBS表映射到Fusion表。
报告开发 --在构建BI Publisher报告之前，请通过对话对SQL进行原型化。AI使用本地模式缓存验证和优化您的查询。
⚠️ 局限性
- 只读SQL —
SELECT仅通过BI发布者SOAP进行查询。Oracle Fusion不允许通过此层进行写访问。 - 安全 --确保使用符合您组织的安全策略。凭据存储在本地，从不传输给第三方。
📄 文档
| 指南 | 说明 |
|---|---|
| 安装和设置 | 关于如何安装、配置和运行二进制文件的详细指南 |
| 完整的MCP服务器参考 | 配置、身份验证、变量和工具的完整参考 |
| 多环境管理 | 交互式配置和切换开发、UAT、prod环境 |
| 语义搜索设置 | 如何启用矢量搜索和REST API目录以实现全功能语义发现 |
🌐 生态系统
ofrag是Oracle Fusion开源生态系统的一部分：
| 项目 | 功能 | 链接 |
|---|---|---|
| 抹布 | MCP服务器——通过Claude、OpenAI、Gemini进行AI驱动的查询 | |
| jdbc | JDBC驱动程序——来自DBeaver、IntelliJ、JVM应用程序、ETL管道的SQL访问 |
📫 联系
- 网站： oraclefusionsql.com
- GitHub问题： 克洛科扎布/ofrag/问题
- 电子邮件： sergey.rudenko.ba@gmail.com
- 领英： 谢尔盖·鲁登科
______________________________________________________________________
If ofrag saved you time, consider leaving a ⭐
The only MCP server for Oracle Fusion Cloud. Built by an Oracle Fusion consultant who got tired of BI Publisher.