Integrates with Atlassian's Confluence and JIRA APIs to enable content creation, issue tracking, and project management...
Created byApr 23, 2025
MCP Atlassian
A Model Context Protocol (MCP) server that provides tools for interacting with Atlassian products (Confluence and Jira).
Overview
This MCP server allows AI agents to interact with Atlassian products through a standardized interface. It provides tools for:
**Confluence**: Search content, get spaces, retrieve content, and list pages
**Jira**: Search issues, get issue details, list projects, and more
Prerequisites
Node.js (v16 or higher)
npm or yarn
Atlassian account with API token
Docker (optional, for containerized deployment)
Installation
Standard Installation
Clone the repository:
```bash
git clone https://github.com/yourusername/mcp-atlassian.git
cd mcp-atlassian
```
Install dependencies:
```bash
npm install
# or using make
make install
```
Create a `.env` file in the root directory with your Atlassian credentials:
```
ATLASSIAN_HOST=https://your-domain.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_TOKEN=your-api-token
```
Docker Installation
Clone the repository:
```bash
git clone https://github.com/yourusername/mcp-atlassian.git
cd mcp-atlassian
```
Create a `.env` file as described above.
Build and run the Docker container:
```bash
# Build the Docker image
make docker-build
# Run the Docker container
make docker-run
# Or use Docker Compose
make docker-compose
```
Usage
Starting the Server
This will start the MCP server, which will listen for requests on stdin and respond on stdout.
Available Tools
Confluence Tools
**search-confluence**: Search for content in Confluence using CQL
- Parameters: `query` (string)
**get-confluence-space**: Get information about a specific Confluence space
- Parameters: `spaceKey` (string)
**get-confluence-content**: Get specific content by ID
- Parameters: `contentId` (string)
**get-confluence-pages**: Get all pages in a space
- Parameters: `spaceKey` (string), `limit` (number, optional)
Jira Tools
**search-jira-issues**: Search for issues using JQL
- Parameters: `jql` (string), `maxResults` (number, optional)
**get-jira-issue**: Get a specific issue by key
- Parameters: `issueKey` (string)
**get-jira-projects**: Get all projects
- Parameters: none
**get-jira-project**: Get a specific project by key
- Parameters: `projectKey` (string)
**get-jira-issue-types**: Get all issue types
- Parameters: none
Development
Project Structure
Building
Testing
Makefile Commands
The project includes a Makefile to simplify common operations:
License
MIT
Contributing
Fork the repository
Create your feature branch (`git checkout -b feature/amazing-feature`)
Commit your changes (`git commit -m 'Add some amazing feature'`)
Push to the branch (`git push origin feature/amazing-feature`)