What can you do with this server?

The PingCode MCP Server enables AI assistants to interact with PingCode project management systems for querying, managing, and updating work items and releases. Authentication Management * login – Open a browser to log into PingCode (supports third-party logins like Feishu/Lark) * logout – Log out and clear locally saved credentials * check_auth – Check the current login/authentication status Work Item Operations * get_work_item – Retrieve details of a work item by identifier (e.g., LFY-123, #12345) * search_work_items – Search for work items by keyword, optionally scoped to a specific project * update_work_item_state – Update the status of a work item by specifying a target state name Bug Management * Update bug-specific fields such as reason analysis, solutions, and resolution methods * Fetch available options for bug fields Project & Release Management * list_projects – List all projects accessible to the authenticated user * list_releases – List all release versions for a given project * get_release_items – Retrieve work items (bugs, stories, or all) associated with a specific release version Credentials are stored locally without third-party data transmission.

How do I use PingCode MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@PingCode MCP Server show me the details for work item LFY-2527" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

PingCode MCP Server

by ratatatat1

Overview Schema Related Servers Score Discussions

TypeScript

Local

PingCode MCP Server

npm version License: MIT

PingCode MCP (Model Context Protocol) 服务器,让 AI 助手能够与 PingCode 项目管理系统交互,支持查询工作项、发布版本管理、更新状态和缺陷字段等操作。

✨ 功能特性

🔐 便捷登录 - 支持浏览器登录和飞书等第三方登录
🔍 工作项查询 - 通过编号快速查看工作项详情
📋 发布管理 - 查询发布版本关联的缺陷和需求
🔎 全文搜索 - 搜索项目中的工作项
📊 版本列表 - 列出项目的所有发布版本
✏️ 状态更新 - 更新工作项的状态
🐛 缺陷管理 - 更新缺陷的原因分析、解决方案和解决方法

📦 安装

方式一：全局安装（推荐）

npm install -g pingcode-mcp

安装后需要安装 Chromium 浏览器（用于登录）:

npx playwright install chromium

方式二：使用 npx（无需安装）

npx pingcode-mcp

首次使用会自动下载依赖。

🚀 快速开始

1. 配置 MCP 客户端

在你的 MCP 客户端（如 Windsurf、Cursor、Claude Desktop）配置文件中添加：

全局安装后的配置

编辑 ~/.cursor/mcp.json 或 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pingcode-mcp": {
      "command": "pingcode-mcp",
      "env": {
        "PINGCODE_DOMAIN": "your-company.pingcode.com"
      }
    }
  }
}

使用 npx 的配置

{
  "mcpServers": {
    "pingcode-mcp": {
      "command": "npx",
      "args": ["-y", "pingcode-mcp"],
      "env": {
        "PINGCODE_DOMAIN": "your-company.pingcode.com"
      }
    }
  }
}

注意: 如果不配置 PINGCODE_DOMAIN，默认使用 neuralgalaxy.pingcode.com。

2. 首次登录

重启 MCP 客户端后，让 AI 助手调用 login 工具:

请帮我登录 PingCode

会自动打开浏览器，完成授权后凭证会保存在 ~/.pingcode-mcp/credentials.json。

3. 开始使用

查看工作项 LFY-2527 的详情

列出优点云项目的所有发布版本

查询发布版本 QxednuAG 的所有缺陷

🛠️ 可用工具

工具名称	说明	参数
`login`	打开浏览器进行登录	无
`logout`	退出登录，清除凭证	无
`check_auth`	检查登录状态	无
`get_work_item`	获取工作项详情	`identifier`: 工作项编号（如 LFY-123）
`list_projects`	列出所有可访问项目	无
`list_releases`	列出项目的发布版本	`project_id`: 项目标识（如 LFY）
`get_release_items`	获取版本关联的工作项	`release_id`: 版本ID `project_id`: 项目标识 `item_type`: bug/story/all
`search_work_items`	搜索工作项	`query`: 搜索关键词 `project_id`: 项目标识（可选）
`update_work_item_state`	更新工作项状态	`work_item_id`: 工作项编号 `state_name`: 目标状态
`get_bug_field_options`	获取缺陷字段可选值	`work_item_id`: 缺陷工作项编号
`update_bug_fields`	更新缺陷的分析和解决方案	`work_item_id`: 工作项编号 `reason`: 原因分析（可选） `solution`: 解决方案（可选） `jiejuefangfa`: 解决方法（可选）

💡 使用示例

查看工作项详情

查看 LFY-2527 的详情

查询发布版本的缺陷

从发布页面 URL 获取参数：

https://yourcompany.pingcode.com/pjm/projects/LFY/releases/QxednuAG/workitems
                                                    ↑              ↑
                                              project_id      release_id

然后询问 AI:

查询项目 LFY 的发布版本 QxednuAG 中的所有缺陷

搜索工作项

在优点云项目中搜索包含"登录"的工作项

更新工作项状态

把 LFY-2527 的状态改为已完成

更新缺陷分析字段

帮我更新 LFY-2527 的原因分析和解决方案

🔧 环境变量

变量名	说明	默认值
`PINGCODE_DOMAIN`	PingCode 域名	`neuralgalaxy.pingcode.com`

🔨 本地开发

如果你想修改源码或为项目贡献代码：

# 克隆仓库
git clone https://github.com/ratatatat1/pingcode-mcp.git
cd pingcode-mcp

# 安装依赖
npm install

# 安装浏览器
npx playwright install chromium

# 开发模式（实时编译）
npm run dev

# 构建
npm run build

# 测试构建产物
npm start

在 MCP 客户端中使用本地开发版本

{
  "mcpServers": {
    "pingcode-mcp": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/pingcode-mcp/src/index.ts"]
    }
  }
}

📂 项目结构

pingcode-mcp/
├── src/
│   ├── index.ts              # MCP 服务器入口
│   ├── api/
│   │   └── pingcode-client.ts # PingCode API 客户端
│   ├── tools/
│   │   ├── login.ts          # 登录相关工具
│   │   └── work-items.ts     # 工作项相关工具
│   ├── types/
│   │   └── pingcode.ts       # TypeScript 类型定义
│   └── utils/
│       └── credentials.ts    # 凭证管理工具
├── dist/                     # 编译输出目录
├── package.json
├── tsconfig.json
└── README.md

🔒 隐私与安全

登录凭证仅保存在本地 ~/.pingcode-mcp/credentials.json
不会上传任何数据到第三方服务器
所有 API 请求直接发送到你的 PingCode 实例

❓ 常见问题

Q: 凭证过期了怎么办？ A: 重新调用 login 工具即可。

Q: 支持哪些 MCP 客户端？ A: 支持所有实现了 MCP 协议的客户端，包括 Windsurf、Cursor、Claude Desktop 等。

Q: 可以在 CI/CD 中使用吗？ A: 登录需要浏览器交互，不适合 CI/CD 环境。如需自动化，建议使用 PingCode API。

📄 许可证

MIT License - 详见 LICENSE 文件

🤝 贡献

欢迎提交 Issue 和 Pull Request！

作者: ratat 关键词: mcp, pingcode, model-context-protocol, ai, release, bug-tracking, project-management

Install Server

security – no known vulnerabilities

license - not found

quality - not tested

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ratatatat1/pingcode-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server