PMS MCP Server

https://www.npmjs.com/package/pms-mcp-server

领悟PMS 系统的 MCP (Model Context Protocol) 服务器，支持通过自然语言指令操作工单和任务。

安装

方式一：npx（推荐，无需克隆代码）

直接在 MCP 客户端配置中使用，首次运行会自动下载：

{
  "mcpServers": {
    "pms": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pms-mcp-server",
        "--username", "你的用户名",
        "--password", "你的密码"
      ]
    }
  }
}

方式二：本地安装（开发/离线环境）

git clone <仓库地址>
cd pms_mcp_server
npm install
npm run build

配置：

{
  "mcpServers": {
    "pms": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/本地路径/pms_mcp_server/dist/index.js",
        "--username", "你的用户名",
        "--password", "你的密码"
      ]
    }
  }
}

Claude Code 配置路径

| 客户端 | 配置文件位置 | |--------|-------------| | Claude Code (全局) | ~/.claude.json | | Claude Desktop (Mac) | ~/Library/Application Support/Claude/claude_desktop_config.json | | Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |

注意：PMS 系统为内网系统，需在内网环境下使用。

功能

工单管理

• 查看工单列表 / 详情
• 创建工单
• 完成 / 解决 / 关闭 / 重新打开工单
• 指派工单
• 记录工单评论

任务管理

• 查看任务列表 / 详情
• 开始 / 完成 / 暂停 / 继续任务
• 创建任务 / 编辑任务
• 记录工时

其他

• 查看 / 签收通知公告
• 上传图片 / 下载附件（支持 PDF 文本提取）

使用示例

查看我的待处理工单
列出北京智想有为项目的工单
获取工单 21993 的详情
完成工单 21993
把工单 21993 指派给王嘉琦
查看我的任务列表
开始任务 12345
记录工时：任务 12345，今天工作了 3 小时

技术栈

• TypeScript + Node.js
• MCP SDK (@modelcontextprotocol/sdk)
• Axios + axios-cookiejar-support（HTTP + Cookie 会话）
• Cheerio（HTML 解析）
• pdf-parse（PDF 文本提取）

开发

npm run dev    # 开发模式（tsx，无需编译）
npm run build  # 编译 TypeScript → dist/
npm start      # 运行编译后的版本

项目结构

pms_mcp_server/
├── src/
│   ├── index.ts          # MCP 服务器入口（工具注册与分发）
│   ├── pms-client.ts     # PMS HTTP 客户端（HTML 解析）
│   └── types.ts          # TypeScript 类型定义
├── dist/                 # 编译输出
├── test/                 # 测试脚本
├── docs/                 # 项目文档
└── scripts/
    └── version-manager.js

详细变更记录请查看 CHANGELOG.md