{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_n92dp97fe642","handle":"g7-jira-mcp","url":"https://wellknown.network/agents/g7-jira-mcp","links":{"self":"https://wellknown.network/agents/g7-jira-mcp/record.json","html":"https://wellknown.network/agents/g7-jira-mcp","markdown":"https://wellknown.network/agents/g7-jira-mcp/record.md","api":"https://wellknown.network/api/v1/agents/g7-jira-mcp","status":"https://wellknown.network/api/v1/agents/g7-jira-mcp/status","claim":"https://wellknown.network/agents/g7-jira-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/g7-jira-mcp/claim.json","badge":"https://wellknown.network/agents/g7-jira-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/g7-jira-mcp/history","tools":"https://wellknown.network/api/v1/agents/g7-jira-mcp/tools"},"ard":{"identifier":"urn:air::server:g7-jira-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"g7-jira-mcp","summary":"JIRA MCP for querying JIRA details and lists","description":"# G7 JIRA MCP\n\n一个基于FastMCP框架的JIRA集成插件，用于查询JIRA问题详情、列表及进行基本操作，支持JIRA附件管理。\n\n## 主要功能\n\n- 查询JIRA问题详情和问题列表\n- 创建和更新JIRA问题\n- 获取项目列表和详情\n- 管理和下载JIRA问题附件\n  - 自动将附件保存到项目根目录的 `.jira-mcp/{issue_key}/` 子目录\n  - 按问题ID组织的子目录结构\n  - 支持下载单个或所有附件\n  - 智能下载机制：自动检测无效内容并使用 Playwright 重新下载\n- **评论管理功能**\n  - 获取问题的所有评论\n  - 添加新评论到问题\n- **工时管理功能**\n  - 添加工时记录到问题\n  - 支持多种时间格式（如 1h、30m、2h 30m、1d、1w）\n- **根据JIRA ID查询GitLab Merge Request**\n  - 从DevLake服务获取与JIRA关联的MR信息\n  - 支持完整ID或部分ID搜索\n  - 返回MR详情、代码变更统计等信息\n- **调试工具**\n  - debug_issue_fields：查看JIRA问题的完整字段结构\n\n## 配置\n\n### 方式一：直接使用（推荐）\n\n使用 `uvx` 方式，无需手动安装，自动下载和管理包：\n\n```bash\nclaude mcp add jira-mcp -- uvx g7-jira-mcp --transport stdio \\\n  --env JIRA_USERNAME=your_username \\\n  --env JIRA_PASSWORD=your_password\n```\n\n### 方式二：先安装后使用\n\n适合需要离线使用或希望固定版本的用户：\n\n```bash\n# 1. 安装包（推荐使用阿里云镜像加速）\npip install g7-jira-mcp -i https://mirrors.aliyun.com/pypi/simple\n\n# 2. 添加到 Claude Code\nclaude mcp add jira-mcp -- g7-jira-mcp --transport stdio \\\n  --env JIRA_USERNAME=your_username \\\n  --env JIRA_PASSWORD=your_password\n```\n\n### 查看和管理\n\n```bash\n# 查看已添加的 MCP 服务器\nclaude mcp list\n\n# 删除 MCP 服务器\nclaude mcp remove jira-mcp\n```\n\n### Cursor / 其他 IDE 配置\n\n如果使用 Cursor 或其他支持 MCP 的 IDE，在配置文件（如 `.cursor/mcp.json`）中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"g7-jira-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from=g7-jira-mcp\",\n        \"g7-jira-mcp\",\n        \"--transport\",\n        \"stdio\"\n      ],\n      \"env\": {\n        \"JIRA_USERNAME\": \"your_username\",\n        \"JIRA_PASSWORD\": \"your_password\"\n      }\n    }\n  }\n}\n```\n\n> **提示**: `JIRA_SERVER_URL` 已有默认值，无需配置。如需修改，添加到 `env` 中即可。\n\n## 快速开始\n\n配置完成后，即可在 Claude Code 或支持 MCP 的 IDE 中使用自然语言操作 JIRA：\n\n**查询问题详情**\n```text\n查看 JIRA 问题 ERP-161 的详情\n```\n\n**搜索问题**\n```text\n搜索所有处于\"进行中\"状态的 JIRA 问题\n```\n\n**管理附件**\n```text\n下载 JIRA 问题 ERP-161 的所有附件\n```\n\n**管理评论**\n```text\n为 ERP-161 添加评论\"已修复此问题\"\n```\n\n**添加工时**\n```text\n为 ERP-161 添加 1 小时工时\n```\n\n**查询关联 MR**\n```text\n查询 ERP-161 关联的 GitLab Merge Request\n```\n\n## MCP提供的工具\n\n本MCP服务器提供以下工具：\n\n| 工具名称 | 描述 | 示例 |\n|---------|------|------…","publisher":null,"homepage":"https://github.com/YOUR_USERNAME/g7-jira-mcp#readme","repository":"https://github.com/YOUR_USERNAME/g7-jira-mcp/issues","version":"0.2.1","license":"MIT","protocols":["mcp"],"tags":["cursor","fastmcp","jira","mcp"],"pricing":null,"endpoints":[{"url":"pypi:g7-jira-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.project-management","name":"Project Management","confidence":1,"provenance":"declared"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"g7-jira-mcp","registry":"pypi","observedAt":"2026-09-15T15:24:32.340Z","publishedAt":"2026-08-12T01:40:26.936756Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"g7-jira-mcp","url":"https://pypi.org/project/g7-jira-mcp/","firstSeenAt":"2026-09-09T16:23:12.397Z","fetchedAt":"2026-09-15T15:22:32.388Z","normalizedAt":"2026-09-15T15:22:32.388Z"}]},"firstSeenAt":"2026-09-09T16:23:12.397Z","updatedAt":"2026-09-15T15:24:32.340Z"}