使用说明
JIRA MCP服务器
一种模型上下文协议(MCP)服务器,提供与JIRA问题交互的工具。此服务器允许您获取分配给用户的问题,获取特定的问题详细信息,并更新问题字段。
特性
- 获取由用户的NTID分配给用户的问题
- 获取有关特定JIRA问题的详细信息
- 更新问题字段(摘要、状态、受让人)
先决条件
- Python 3.x
- 以适当的权限访问JIRA实例
- JIRA API代币
安装
- 安装所需的依赖项:
pip install fastmcp requests
- 设置环境变量:
创建一个 .env 根目录中的文件,包含以下变量:
JIRA_URL=your_jira_instance_url
JIRA_TOKEN=your_jira_api_token
PORT=8000 # Optional, defaults to 8000
运行服务器
- 启动MCP服务器:
python main.py
服务器将于启动 http://127.0.0.1:8000 默认情况下。
可用工具
1.通过NTID获取问题
- 工具:
get_issues - 描述:检索由用户的NTID分配给用户的问题
- 退货:问题列表,包括摘要、状态、受让人和描述
2.获取问题详细信息
- 工具:
get_issue - 描述:按ID获取特定问题的详细信息
- 退货:问题详细信息,包括摘要、状态、受让人、描述、创建日期和更新日期
3.更新问题
- 工具:
update_issue - 说明:更新特定问题的字段
- 可更新的字段:摘要、状态、受让人
Docker支持
包含一个用于容器化部署的Dockerfile。要使用Docker构建和运行:
# Build the Docker image
docker build -t jira-mcp-server .
# Run the container
docker run -p 8000:8000 --env-file .env jira-mcp-server
环境变量
| 变量 | 描述 | 必填 |
|---|---|---|
| JIRA_URL | 您的JIRA实例URL | 是 |
| JIRA_TOKEN | 用于身份验证的JIRA API令牌 | 是 |
| PORT | 服务器端口(默认值:8000) | 否 |
