数据集成API服务器

MCP_IDMC是一个将Informatica智能数据管理云(IDMC)的数据集成API暴露为MCP工具的服务,允许AI代理通过自然语言查询、运行和监控CDI映射。

  • by andregit2026
  • HTML
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 andregit2026/MCP_IDMC

使用说明

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分析报告。

用途:

  1. 从IDMC导出映射(导出>映射)
  2. 提取导出包
  3. 更新路径 scripts/generate_mapping_report.py:
    • API映射JSON的路径(来自 get_mapping() 或保存在本地)
    • 导出路径 @3.bin 文件(通常在 Explore/[Project]/[Folder]/[Mapping].DTEMPLATE.zip/bin/@3.bin)
  4. 运行脚本:
    python scripts/generate_mapping_report.py
    
  5. 在中查找生成的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帐户