FCCS MCP Agentic 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_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 端点

文档

• Windows部署指南 -完成Windows安装
• -存储库设置和配置
• 快速部署 -Google Cloud Run部署
• ChatGPT快速入门 -ChatGPT集成
• 仪表板快速入门 -性能仪表板

许可证

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