MCP Atlassian

by samwang0723

Integrations

  • Provides tools for interacting with Atlassian products (Confluence and Jira) through a standardized interface

  • Allows searching content, getting spaces, retrieving content, and listing pages in Confluence

  • Enables searching issues, getting issue details, listing projects, and more in Jira

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

  1. Clone the repository:
    git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
  2. Install dependencies:
    npm install # or using make make install
  3. 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

  1. Clone the repository:
    git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
  2. Create a .env file as described above.
  3. Build and run the Docker container:
    # 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

# Using npm npm start # Using make make start # Using Docker make docker-run

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

src/ ├── config/ # Configuration files ├── examples/ # Example usage ├── services/ # Service classes for Atlassian APIs │ ├── confluence.ts │ └── jira.ts ├── tools/ # MCP tools │ ├── search-confluence.ts │ ├── get-confluence-space.ts │ ├── get-confluence-content.ts │ ├── get-confluence-pages.ts │ ├── search-jira-issues.ts │ ├── get-jira-issue.ts │ ├── get-jira-projects.ts │ ├── get-jira-project.ts │ ├── get-jira-issue-types.ts │ ├── utils.ts │ └── index.ts └── index.ts # Main entry point

Building

# Using npm npm run build # Using make make build

Testing

# Using npm npm test # Using make make test

Makefile Commands

The project includes a Makefile to simplify common operations:

# Display available commands make help

License

MIT

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request
-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that enables AI agents to interact with Atlassian products (Confluence and Jira) for content management, issue tracking, and project management through a standardized interface.

  1. Overview
    1. Prerequisites
      1. Installation
        1. Standard Installation
        2. Docker Installation
      2. Usage
        1. Starting the Server
        2. Available Tools
      3. Development
        1. Project Structure
        2. Building
        3. Testing
        4. Makefile Commands
      4. License
        1. Contributing

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
            Last updated -
            27
            1,246
            Python
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            Enables AI applications to manage JIRA issues, workflows, and tasks through a standardized MCP interface, facilitating real-time updates and seamless interaction with JIRA's API.
            Last updated -
            6
            Python
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            An MCP server implementation that standardizes how AI applications access tools and context, providing a central hub that manages tool discovery, execution, and context management with a simplified configuration system.
            Last updated -
            9
            Python
            MIT License
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.
            Last updated -
            32
            80
            5
            TypeScript
            MIT License
            • Apple

          View all related MCP servers

          ID: w8drdld8a6