使用说明
MCP_IDMC——信息IDMC MCP服务器
A. FastMCP 暴露的服务器 Informatica智能数据管理云(IDMC)数据集成 API作为MCP工具,允许AI代理(Claude等)通过自然语言查询、运行和监视CDI映射。
工具
数据集成(CDI)
| 工具 | 说明 |
|---|---|
list_mappings |
列出组织中的所有数据集成映射 |
get_mapping(mapping_id) |
获取特定映射的完整元数据 |
run_mapping_task(task_id) |
根据任务ID触发映射任务 |
get_job_status() |
返回当前正在运行的所有作业的状态 |
get_activity_log(task_id, row_limit) |
返回任务的已完成运行历史记录 |
设置
1.安装依赖项
pip install -r requirements.txt
2.配置凭据
cp .env.example .env
编辑 .env:
IDMC_USER=your@email.com
IDMC_PASS=yourpassword
3.运行服务器
python src/server.py
4.在克劳德代码中注册
添加 ~/.claude/mcp.json:
{
"mcpServers": {
"idmc": {
"command": "python",
"args": ["C:/path/to/MCP_IDMC/src/server.py"],
"env": {
"IDMC_USER": "your@email.com",
"IDMC_PASS": "yourpassword"
}
}
}
}
运作原理
服务器根据IDMC REST API进行身份验证(/ma/api/v2/user/login)并使用返回的 serverUrl 和 icSessionId 对于所有后续的CDI调用。会话有效期约为2小时。
AI Agent (Claude)
│
│ MCP tool call
▼
FastMCP server (src/server.py)
│
│ IDMC REST API /api/v2/mapping
│ /api/v2/job
│ /api/v2/activity/activityLog
│ /api/v2/activity/activityMonitor
▼
Informatica IDMC (CDI)
项目结构
MCP_IDMC/
├── src/
│ └── server.py # Main MCP server application
├── scripts/
│ └── generate_mapping_report.py # Generate HTML reports from mapping exports
├── json/
│ └── mapping_sample.json # Sample mapping metadata
├── output/
│ └── *.html # Generated HTML analysis reports
├── .env # Your IDMC credentials (not in git)
├── .env.example # Template for credentials
├── requirements.txt # Python dependencies
└── README.md # This file
脚本
映射报告生成器
从导出的IDMC映射生成漂亮的HTML分析报告。
用途:
- 从IDMC导出映射(导出>映射)
- 提取导出包
- 更新路径
scripts/generate_mapping_report.py:- API映射JSON的路径(来自
get_mapping()或保存在本地) - 导出路径
@3.bin文件(通常在Explore/[Project]/[Folder]/[Mapping].DTEMPLATE.zip/bin/@3.bin)
- API映射JSON的路径(来自
- 运行脚本:
python scripts/generate_mapping_report.py - 在中查找生成的HTML报告
output/
报告包括:
- 一般映射信息(创建者、时间戳、状态)
- 按类型计数的转换摘要
- 详细的转换分解(源、表达式、聚合器、目标)
- 可视化数据流图
- 测绘目的说明
IDMC吊舱配置
服务器已为预配置 dm1-em 豆荚:
| 设置 | 值 |
|---|---|
| 登录URL | https://dm1-em.informaticacloud.com/ma/api/v2/user/login |
| CDI API基地 | <serverUrl>/api/v2/ (登录时返回) |
| CAI基本URL | https://emc1-cai.dm1-em.informaticacloud.com/active-bpel/rt/ |
要使用其他pod,请更新 LOGIN_URL 和 CAI_BASE_URL 在 src/server.py.
需求
- Python 3.10+
fastmcp,mcp,requests- 具有CDI访问权限的活动Informatica IDMC帐户
