61 lines
1.4 KiB
Markdown

# @mcpengine/jira
Complete MCP server for Jira/Atlassian integration.
## Features
- 60+ tools covering issues, projects, boards, sprints, users, comments, attachments, transitions, fields, filters, dashboards, and webhooks
- 18 React-based UI apps for visual interaction
- Full TypeScript support with strict type checking
- Rate limiting and pagination handling
- Support for both Basic Auth (email+API token) and OAuth2 Bearer tokens
## Setup
1. Copy `.env.example` to `.env` and fill in your credentials:
```bash
cp .env.example .env
```
2. Install dependencies:
```bash
npm install
```
3. Build:
```bash
npm run build
```
4. Run:
```bash
npm start
```
## Development
```bash
npm run dev
```
## Authentication
### Basic Auth (Recommended)
Set `JIRA_DOMAIN`, `JIRA_EMAIL`, and `JIRA_API_TOKEN` in your `.env` file.
### OAuth2 Bearer Token
Set `JIRA_DOMAIN` and `JIRA_BEARER_TOKEN` in your `.env` file.
## Available Tools
See `src/tools/` for the complete list of 60+ tools organized by category.
## Apps
18 React-based UI apps available in `src/apps/`:
- issue-tracker, project-dashboard, board-view, sprint-planner
- backlog-manager, kanban-board, user-directory, comment-feed
- attachment-manager, workflow-editor, field-configurator, filter-builder
- dashboard-viewer, jql-console, roadmap-view, velocity-chart
- burndown-chart, release-manager