AI导哈

Oracle Fusion数据查询服务器

ofrag是一个MCP服务器，允许AI代理通过自然语言直接访问Oracle Fusion云数据，实现快速SQL查询和数据分析。

  • by krokozyab
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 krokozyab/ofrag

使用说明

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)
  2. 理解 “未付”是指 PAYMENT_STATUS_FLAG = 'N'
  3. 验证 针对本地元数据的SQL——在错误投入生产之前捕获错误
  4. 执行 对实时Oracle Fusion实例的查询
  5. 退货 包含发票编号、金额和日期的格式化表格

总时间：~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驱动的查询 GitHub
jdbc JDBC驱动程序——来自DBeaver、IntelliJ、JVM应用程序、ETL管道的SQL访问 GitHub

📫 联系

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.

相关 MCP