Idmc CDI Jobs MCP Server

带有 Claude Skills 的 IDMC 作业 MCP 服务

一个 MCP 服务，通过模型上下文协议将 Informatica IDMC 作业管理功能作为 AI 可调用工具提供，包括身份验证、启动/停止、状态监控和活动日志查询。

作者： Pavan Kumar SP

一个用于监控和管理 Informatica Intelligent Data Management Cloud (IDMC) 平台上作业的模型上下文协议 (MCP) 服务。

本项目包含一个 Claude Skill，可让你直接在 Claude 或 Cursor 中使用自然语言与 IDMC 作业交互。使用 /idmc 斜杠命令即可启动/停止作业、检查状态、查询活动日志等，无需编写代码。有关完整的意图到工具映射及交互示例，请参阅 Claude Skill 参考。

功能

工具	描述
idmc_login	进行身份验证并获取 IDMC 会话
idmc_set_session	恢复之前获取的会话令牌
idmc_logout	使当前会话失效
idmc_start_job	启动任意 IDMC 任务类型（MTT、DSS、DRS、DMASK、PCS、WORKFLOW）
idmc_stop_job	停止正在运行的作业（立即停止或平滑清理停止）
idmc_get_job_status	获取运行 ID 的实时状态和行数
idmc_get_activity_log	使用丰富的筛选条件查询活动日志
idmc_get_active_jobs	列出所有当前正在运行的作业
idmc_get_job_history	检索历史执行记录
idmc_get_session_info	查看当前身份验证状态

支持的任务类型

代码	类型
MTT	映射任务
DSS	同步任务
DRS	复制任务
DMASK	屏蔽任务
PCS	PowerCenter 任务
WORKFLOW	线性任务流

---

快速开始

1. 安装并构建

npm install
npm run build

2. 配置凭据

将 .env.example 复制为 .env，并填写你的 IDMC 凭据：

cp .env.example .env

变量	描述
IDMC_USERNAME	你的 IDMC 登录邮箱
IDMC_PASSWORD	你的 IDMC 密码
IDMC_BASE_URL	你的 pod 的登录 URL（例如 https://dm-us.informaticacloud.com）
IDMC_SERVER_URL	（可选） 之前登录时获取的现有 serverUrl
IDMC_SESSION_ID	（可选） 之前登录时获取的现有 icSessionId

3. 添加到 Claude Desktop

将 claude_desktop_config.json 的内容合并到你的 Claude Desktop 配置文件中：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "idmc-jobs": {
      "command": "node",
      "args": ["/path/to/idmc-jobs/dist/index.js"],
      "env": {
        "IDMC_USERNAME": "[email protected]",
        "IDMC_PASSWORD": "your-password",
        "IDMC_BASE_URL": "https://dm-us.informaticacloud.com"
      }
    }
  }
}

---

API 参考

身份验证

当设置了 IDMC_USERNAME 和 IDMC_PASSWORD 环境变量时，服务会在启动时自动进行身份验证。你也可以随时手动调用 idmc_login。

登录流程：

1. 向 <IDMC_BASE_URL>/ma/api/v2/user/login 发送 POST 请求
2. 响应包含 serverUrl（用作所有 v2 API 调用的基础 URL）和 icSessionId（在每个请求标头中发送的会话令牌）

启动作业

idmc_start_job({
  taskType: "MTT",
  taskName: "MyMappingTask",
  callbackURL: "https://my-app.com/webhook"
})

返回 runId，可用它通过 idmc_get_job_status 跟踪进度。

监控

idmc_get_job_status({ runId: 123456 })

idmc_get_activity_log({
  taskType: "MTT",
  startTime: "2024-01-01T00:00:00Z",
  limit: 50
})

idmc_get_active_jobs()

停止作业

# Immediate stop
idmc_stop_job({ taskType: "MTT", taskName: "MyMappingTask" })

# Graceful clean stop (finishes in-flight rows)
idmc_stop_job({ taskType: "MTT", taskName: "MyMappingTask", cleanStop: true })

---

各区域的 IDMC Base URL

区域	URL
美国	https://dm-us.informaticacloud.com
欧洲	https://dm-eu.informaticacloud.com
亚太地区	https://dm-ap.informaticacloud.com
APAC Pod 1	https://dm1-ap.informaticacloud.com

---

项目结构

idmc-jobs/
├── src/
│   ├── index.ts          # MCP server — tools, handlers, startup
│   └── idmc-client.ts    # IDMC REST API client (login, jobs, activity log)
├── dist/                 # Compiled output (after npm run build)
├── .env.example          # Environment variable template
├── claude_desktop_config.json
├── tsconfig.json
└── package.json

开发

npm run dev   # Run with ts-node (no build needed)
npm run build # Compile to dist/
npm start     # Run compiled dist/index.js