JPI MCP Server

JPI MCP服务器

模型上下文协议（MCP）服务器 Just Plan It（JPI） API集成。该服务器使AI助手能够与JPI作业调度和资源管理系统进行交互。

特性

• 69 MCP工具 涵盖所有JPI API端点
• 所有JPI实体的完整CRUD操作
• 批量操作，实现高效批量更新
• 跨作业任务操作
• 类型安全的TypeScript实现
• 全面的错误处理

快速开始

先决条件

• Node.js 18+
• JPI API令牌（从 只是计划一下)

克劳德代码CLI

claude mcp add jpi \
  --transport stdio \
  --env JPI_API_TOKEN=your-api-token-here \
  --scope user \
  -- npx -y jpi-mcp

克劳德桌面

添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "jpi": {
      "command": "npx",
      "args": ["-y", "jpi-mcp"],
      "env": {
        "JPI_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

直接CLI使用

对于其他CLI工具或直接使用shell：

Unix/macOS/Linux：

JPI_API_TOKEN=your-token npx -y jpi-mcp

Windows PowerShell：

$env:JPI_API_TOKEN="your-token"; npx -y jpi-mcp

Windows CMD:

set JPI_API_TOKEN=your-token && npx -y jpi-mcp

环境变量

建筑

jpi-mcp/
├── src/
│   ├── index.ts          # MCP server setup, 69 tool definitions, request handlers
│   ├── client.ts         # JpiClient class - HTTP client for JPI API v1
│   └── types/            # TypeScript types matching JPI API schemas
│       ├── index.ts      # Re-exports all types
│       ├── enums.ts      # OrderStatus, Strategy, TaskStatus, EventType, etc.
│       ├── schemas.ts    # Common schemas (Identifier, HyperLink, ResourceGroupConstraint)
│       ├── jobs.ts       # Job, Task, JobComponentReference types
│       ├── components.ts # Component, ComponentTask types
│       ├── templates.ts  # JobTemplate, TemplateTask, TemplateComponentReference types
│       ├── resources.ts  # Resource, ResourceGroup, ResourceCategory types
│       ├── settings.ts   # Application settings types
│       └── events.ts     # JPI event/change log types
└── package.json

关键概念

工作和任务

• 工作：包含一个或多个任务的生产订单或工作订单
• 任务：作业中的单个操作（例如切割、焊接、涂漆）
• 前任：任务开始前必须完成的任务
• 任务连接：用于调度协调的链接任务

组件和参考

• 组件：可由作业引用的可重用任务模板
• JCR（工作组件参考）：将组件链接到作业，自动创建任务
• TCR（模板组件参考）：将组件链接到作业模板

资源层次结构

Resource Categories
    └── Resource Groups
            └── Resources (machines, workers, etc.)

时间单位

重要： JPI API中的所有时间字段都在 秒，而不是分钟。

字段命名约定

所有API字段都使用 帕斯卡命名法 以精确地匹配JPI API（例如。， DueDate, TaskNo, ResourceGroupConstraints).

可用工具（共69个）

助手（1个工具）

组件（9个工具）

工作（27工具）

作业模板（13个工具）

JPI事件（2个工具）

资源类别（5个工具）

资源组（5个工具）

资源（5个工具）

设置（2个工具）

使用示例

使用任务创建作业

{
  "Name": "Production Order 001",
  "JobNo": "PO-001",
  "DueDate": "2024-12-31T17:00:00",
  "ReleaseDate": "2024-12-01T08:00:00",
  "Strategy": "Asap",
  "OrderStatus": "Released",
  "Customer": "ACME Corp",
  "Quantity": 100,
  "Tasks": [
    {
      "TaskNo": "T010",
      "Name": "Laser Cutting",
      "ProductionTimePerUnit": 60,
      "SetupTime": 900,
      "ResourceGroupConstraints": [
        {
          "ResourceGroup": "resource-group-guid-here"
        }
      ]
    },
    {
      "TaskNo": "T020",
      "Name": "Welding",
      "ProductionTimePerUnit": 120,
      "PredecessorTaskNos": ["T010"],
      "ResourceGroupConstraints": [
        {
          "ResourceGroup": "welding-group-guid"
        }
      ]
    }
  ]
}

更新任务状态

{
  "jobGuid": "job-guid-here",
  "taskGuid": "task-guid-here",
  "TaskStatus": "Started"
}

批量创建作业

{
  "jobs": [
    { "Name": "Job 1", "Tasks": [...] },
    { "Name": "Job 2", "Tasks": [...] },
    { "Name": "Job 3", "Tasks": [...] }
  ]
}

枚举和类型

订单状态

策略

任务状态

错误处理

所有工具都返回结构化错误响应：

{
  "error": true,
  "status": 400,
  "statusText": "Bad Request",
  "message": "JPI API Error: 400 Bad Request",
  "body": {
    "details": "Validation failed for field 'Name'"
  }
}

发展

构建

npm run build

观看模式

npm run dev

在本地运行

JPI_API_TOKEN=your-token npm start

来源

git clone https://github.com/anthropics/jpi-mcp.git
cd jpi-mcp
npm install
npm run build
npm start

API 参考

此MCP服务器包装JPI REST API v1。关于API的详细文件：

• JPI API Swagger
• 只是计划它的网站

许可证

麻省理工学院

贡献

欢迎投稿！请打开问题或提交拉取请求。