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（推荐）
自动设置：```powershell
.\setup-windows.bat
这将：
- 创建虚拟环境
- 安装所有依赖项
- 创建 `.env` 模板文件
- 指导您完成配置
**手动设置：**
1. 创建虚拟环境： `python -m venv venv`
1. 激活 `.\venv\Scripts\Activate.ps1`
1. 安装： `pip install -e .`
1. 配置：复制 `.env.example` 到 `.env` 并编辑
1. 初始化数据库： `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.安装依赖关系：**```bash
pip install -e .
2.配置环境：```bash
cp .env.example .env
Edit .env with your settings
**3.运行：**
**MCP服务器（用于克劳德桌面）：**```bash
python -m cli.mcp_server
Web服务器（用于API访问）：```bash
python -m web.server
**交互式CLI：**```bash
python -m cli.main
Claude桌面配置
增添 %APPDATA%\Claude\claude_desktop_config.json:```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服务配置
- 故障排除
码头工人```bash
docker build -t fccs-agent .
docker run -p 8080:8080 --env-file .env fccs-agent
### 谷歌云运行```bash
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安装
- GitHub安装指南 -存储库设置和配置
- 快速部署 -Google Cloud Run部署
- ChatGPT快速入门 -ChatGPT集成
- 仪表板快速入门 -性能仪表板
许可证
麻省理工学院
