Jira MCP Server
A Model Context Protocol server implementation for Jira integration. This server allows AI models to interact with Jira through a standardized interface.
Features
- Full Jira REST API integration
- Connection pooling for optimal performance
- Comprehensive error handling
- Type-safe implementation
- Built-in rate limiting
- Request logging and monitoring
Installation
npm install @modelcontextprotocol/server-jira
Configuration
The server requires the following environment variables:
JIRA_HOST=your-domain.atlassian.net
JIRA_API_TOKEN=your-api-token
[email protected]
PORT=3000 # Optional, defaults to 3000
POOL_SIZE=10 # Optional, defaults to 10
Usage
Starting the Server
# Development mode
npm run dev
# Production mode
npm run build
npm start
API Endpoints
GET /health- Health check endpointGET /api/v1/issues/:issueKey- Get issue detailsGET /api/v1/sprint/current- Get current sprint detailsGET /api/v1/analytics/workload- Get workload analytics
Development
Prerequisites
- Node.js 14 or higher
- npm 6 or higher
Setup
- Clone the repository
- Install dependencies:
npm install - Set up environment variables
- Start development server:
npm run dev
Testing
# Run tests
npm test
# Run linter
npm run lint
# Format code
npm run format
Contributing
Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
License
This project is licensed under the MIT License - see the LICENSE file for details.
