内容
# Jira MCP 服务器
一个遵循[模型上下文协议（MCP）](https://modelcontextprotocol.io)的服务器，开放 Jira Cloud 给 Claude 以及其他大型语言模型代理使用 —— 实现直接从 AI 聊天或代理工作流中以编程方式管理 Epic、故事、任务和冲刺技术栈：** Node.js, TypeScript, Fastify, PostgreSQL, Liquibase
## 功能描述
Jira Cloud 操作作为 MCP 工具公开（创建/更新/查询问题，管理冲刺，Epic）
- 在 PostgreSQL 中持久化对话上下文和工具历史
- 可作为 Docker与 MCP 客户端一起部署
快速开始
```bash
1. 复制环境变量模板并填写您的 Jira 凭证
.example .env
# 2. 使用 Docker Compose 启动（包括 Postgres-compose up
# 3. 运行数据库迁移
docker-compose --profile --rm liquibase
```
## 配置
所需环境变量（参见 `.`）：
| 变量名 | 描述 |
|---|---|
| `JIRA_BASE_URL` | 您的 Jira Cloud URL（例如 `https://.atlassian.net`） |
| `JIRA_EMAIL` | Atlassian 账户邮箱 |
| `JIRA_API_TOKEN` | Jira API token id.atlassian.com 上生成） `POSTGRES_PASSWORD` | |
## 开发
```bash
npm run start:dev # 监视模式
npm run # 单元测试
npm:e2e # 端到端测试
npm run build # 编译到 dist/
```
## MCP 客户端设置
将以下配置添加到您的 MCP 客户端配置文件（例如 Claude Code `.mcp.json`）：
```json
{
"mcpServers": {
"jira": {
"command": "docker",
"args": ["run", "--rm", "-i", "--env-file", ".env", "jira-mcp"]
}
}
}
```
