@galaxycore/pms-mcp

项目管理系统 (PMS) 的 MCP 服务，为 AI Agent 提供任务、缺陷、用户、项目、文件、评论等管理能力。

使用方式

在 Cursor 中使用

在 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "pms": {
      "command": "npx",
      "args": ["-y", "@galaxycore/pms-mcp@latest"],
      "env": {
        "PMS_API_BASE_URL": "https://pms.example.com",
        "PMS_API_TOKEN": "your-token"
      }
    }
  }
}

在 Claude Desktop 中使用

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "pms": {
      "command": "npx",
      "args": ["-y", "@galaxycore/pms-mcp@latest"],
      "env": {
        "PMS_API_BASE_URL": "https://pms.example.com",
        "PMS_API_TOKEN": "your-token"
      }
    }
  }
}

环境变量说明

| 变量 | 必填 | 说明 | |------|------|------| | PMS_API_BASE_URL | 是 | PMS API 基础地址 | | PMS_API_TOKEN | 是 | API Token，请求头携带 Authorization: Token <value> | | PMS_API_TIMEOUT | 否 | 请求超时毫秒数（默认 30000） |

功能概览

| 领域 | 工具 | 数量 | |------|------|------| | 任务 | list_tasks get_task create_task update_task delete_task list_personal_tasks list_team_tasks list_project_tasks get_task_activities quick_complete_task bulk_update_tasks list_task_types add_task_attachment | 13 | | 缺陷 | list_issues get_issue create_issue update_issue delete_issue import_issues | 6 | | 用户 | get_current_user list_users get_user get_user_profile list_simple_users list_team_members list_my_teams list_assignees | 8 | | 项目 | list_projects get_project create_project update_project delete_project get_project_members get_project_milestones get_project_tasks list_project_templates | 9 | | 文件 | list_files get_file upload_file upload_local_file list_documents get_document download_file | 7 | | 评论 | list_comments create_comment update_comment delete_comment pin_comment | 5 |

总计 48 个 MCP 工具

发布

# 构建
npm run build

# 发布到 npm
npm publish --access public

# 或发布到 Gitea npm registry
npm publish --registry https://gitea.wochacha.cn/api/packages/galaxycore/npm/

本地开发

npm install
cp .env.example .env   # 编辑填入实际配置
npm run dev             # stdio 模式
npm run dev:http        # HTTP 模式

项目结构

src/
├── index.ts          # stdio 入口（npx 默认使用）
├── http.ts           # Streamable HTTP 入口
├── server.ts         # McpServer 创建 + 工具注册
├── config.ts         # 环境变量配置
├── client/
│   ├── index.ts      # PMS API HTTP 客户端
│   └── types.ts      # API 类型定义
├── tools/
│   ├── index.ts      # 工具注册入口
│   ├── tasks.ts      # 任务管理 (13 tools)
│   ├── issues.ts     # 缺陷管理 (6 tools)
│   ├── users.ts      # 用户查询 (8 tools)
│   ├── projects.ts   # 项目管理 (9 tools)
│   ├── files.ts      # 文件上传/下载 (7 tools)
│   └── comments.ts   # 评论管理 (5 tools)
└── utils/
    ├── errors.ts     # 错误处理
    └── response.ts   # 响应构造

技术栈

• Runtime: Node.js 20+
• Language: TypeScript
• MCP SDK: @modelcontextprotocol/sdk v1.27.1
• Validation: Zod v4
• Build: tsup (ESM, single-file bundle)
• PMS Backend: Django REST Framework