AI导哈

财务合并与结算代理服务器

Oracle EPM Cloud财务合并与结算(FCCS)的代理服务器，支持MCP和REST API，提供25+工具、双模式运行及PostgreSQL持久化。

  • by ivossos
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ivossos/fccs-mcp-ag-server

使用说明

FCCS MCP代理服务器

Oracle EPM Cloud Financial Consolidation and Close（FCCS）代理服务器，使用带有MCP支持的Google ADK。

特性

  • 25+FCCS工具：全面覆盖Oracle FCCS REST API
  • 双模式：MCP服务器（Claude Desktop）+Web API（FastAPI）
  • 记忆与反馈：PostgreSQL持久性与RL跟踪
  • 模拟模式：没有真正FCCS连接的开发
  • 双语：英语和葡萄牙语支持

快速开始

Windows（推荐）

自动设置：

.\setup-windows.bat

这将：

  • 创建虚拟环境
  • 安装所有依赖项
  • 创建 .env 模板文件
  • 指导您完成配置

手动设置：

  1. 创建虚拟环境： python -m venv venv
  2. 激活 .\venv\Scripts\Activate.ps1
  3. 安装： pip install -e .
  4. 配置：复制 .env.example 到 .env 并编辑
  5. 初始化数据库： python scripts\init_db.py （如果使用PostgreSQL）

快速命令：

  • 启动web服务器： .\start-server.bat
  • 启动MCP服务器： .\start-mcp-server.bat
  • 安装依赖项： .\install-dependencies.bat
  • 初始化数据库： .\init-database.bat

看 风力_深度.md 有关详细的Windows安装指南。

Linux/Mac

1.安装依赖关系：

pip install -e .

2.配置环境：

cp .env.example .env
# Edit .env with your settings

3.运行：

MCP服务器（用于克劳德桌面）：

python -m cli.mcp_server

Web服务器（用于API访问）：

python -m web.server

交互式CLI：

python -m cli.main

Claude桌面配置

增添 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "fccs-agent": {
      "command": "python",
      "args": ["-m", "cli.mcp_server"],
      "cwd": "C:\\path\\to\\fccs-mcp-ag-server",
      "env": {
        "FCCS_MOCK_MODE": "true"
      }
    }
  }
}

API终点

端点 方法 描述
/ GET 健康检查
/tools GET 列出可用工具
/execute POST 执行工具
/tools/{name} POST 呼叫专用工具
/feedback POST 提交用户反馈
/metrics GET 获取工具指标

可用工具

应用

  • get_application_info -FCCS应用程序详细信息
  • get_rest_api_version -API版本信息

工作

  • list_jobs -列出最近的工作
  • get_job_status -按ID列出的作业状态
  • run_business_rule -执行业务规则
  • run_data_rule -执行数据加载规则

维度

  • get_dimensions -列出所有尺寸
  • get_members -获取维度成员
  • get_dimension_hierarchy -构建层次结构树

期刊

  • get_journals -列出期刊
  • get_journal_details -日志详细信息
  • perform_journal_action -批准、拒绝、发布
  • update_journal_period -更新周期
  • export_journals / import_journals

数据

  • export_data_slice -导出网格数据
  • smart_retrieve -智能数据检索
  • copy_data / clear_data

报告

  • generate_report -生成FCCS报告
  • get_report_job_status -异步报告状态

整合

  • export_consolidation_rulesets / import_consolidation_rulesets
  • validate_metadata
  • generate_intercompany_matching_report
  • import_supplementation_data
  • deploy_form_template

建筑

fccs-mcp-ag-server/
├── fccs_agent/           # Main package
│   ├── agent.py          # Agent orchestration
│   ├── config.py         # Configuration
│   ├── client/           # FCCS HTTP client
│   ├── tools/            # 25+ tool modules
│   └── services/         # Feedback service
├── cli/                  # CLI & MCP server
│   ├── main.py           # Interactive CLI
│   └── mcp_server.py     # MCP stdio server
└── web/                  # FastAPI server
    └── server.py

部署

视窗

看 风力_深度.md 有关完整的Windows部署指南，包括：

  • 先决条件安装
  • 自动设置脚本
  • Windows服务配置
  • 故障排除

码头工人

docker build -t fccs-agent .
docker run -p 8080:8080 --env-file .env fccs-agent

谷歌云运行

gcloud run deploy fccs-agent \
  --source . \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars FCCS_MOCK_MODE=true

看 QUICK_DEPLOY.md 了解详细的Cloud Run部署。

反馈系统

代理跟踪工具执行以进行强化学习：

  • 自动：执行时间、成功/失败、错误
  • 用户反馈：1-5级通过 /feedback 端点
  • 指标：通过以下方式汇总统计数据 /metrics 端点

文档

许可证

麻省理工学院 #� �f�c�c�s�-�m�c�p�-�a�g�-�s�e�r�v�e�r� � �

相关 MCP