kompallik ATLASSIAN MCP

A Model Context Protocol (MCP) server for integrating with Atlassian JIRA and Confluence. This server provides tools to interact with JIRA tickets and Confluence pages through the MCP protocol.

• Get JIRA ticket details
• Search for JIRA tickets using JQL
• Create new JIRA tickets
• Add comments to JIRA tickets
• Get Confluence page content
• Search for content in Confluence

• Node.js 16 or higher
• An Atlassian Cloud account
• An Atlassian API token

1. Open Cline
2. Go to Settings > MCP Servers
3. Select the "Marketplace" tab
4. Search for "Atlassian"
5. Click "Install"
6. Configure your Atlassian credentials when prompted

npm install -g atlassian-mcp-server

1. Clone the repository
2. Run the install script:

./install.sh

Or manually:

1. Install dependencies

npm install

1. Build the project

npm run build

1. Install globally

npm install -g .

1. Run the setup

atlassian-mcp-setup

You can configure the server using the setup script, a configuration file, or environment variables.

Run the setup script to create your configuration file:

npx atlassian-mcp-setup

Or if installed locally:

npm run setup

The script will guide you through the configuration process and create a config.json file in the config directory.

1. Create a config.json file in the config directory (you can copy from config.sample.json)
2. Fill in your Atlassian details:

{
  "atlassian": {
    "baseUrl": "https://your-instance.atlassian.net",
    "email": "your-email@example.com",
    "token": "your-api-token-here"
  },
  "server": {
    "name": "atlassian-server",
    "version": "0.1.0"
  }
}

Set the following environment variables:

• ATLASSIAN_BASE_URL: Your Atlassian instance URL (e.g., https://your-instance.atlassian.net)
• ATLASSIAN_EMAIL: Your Atlassian account email
• ATLASSIAN_TOKEN: Your Atlassian API token
• ATLASSIAN_CONFIG_PATH: (Optional) Path to a custom config file location

1. Log in to your Atlassian account at https://id.atlassian.com/manage-profile/security/api-tokens
2. Click "Create API token"
3. Give your token a name (e.g., "MCP Server")
4. Copy the generated token (you won't be able to see it again)

atlassian-mcp-server

Or if installed from source:

npm start

1. Open Cline
2. Go to Settings > MCP Servers
3. Select the "Marketplace" tab
4. Search for "Atlassian"
5. Click "Install"
6. Configure your Atlassian credentials when prompted

If you've installed the server manually, add the following to your MCP settings:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_CONFIG_PATH": "/path/to/your/config.json"
      },
      "disabled": false
    }
  }
}

Alternatively, you can provide the credentials directly in the settings:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_TOKEN": "your-api-token-here"
      },
      "disabled": false
    }
  }
}

Get details of a JIRA ticket by key.

Parameters:

• ticket_key: JIRA ticket key (e.g., "PROJ-123")

Search for JIRA tickets using JQL.

Parameters:

• jql: JQL query string
• max_results: Maximum number of results to return (default: 10)

Create a new JIRA ticket.

Parameters:

• project_key: Project key (e.g., "PROJ")
• summary: Ticket summary/title
• description: Ticket description
• issue_type: Issue type (e.g., "Bug", "Task", "Story") (default: "Task")

Add a comment to a JIRA ticket.

Parameters:

• ticket_key: JIRA ticket key (e.g., "PROJ-123")
• comment: Comment text

Get a Confluence page by ID.

Parameters:

• page_id: Confluence page ID

Search for content in Confluence.

Parameters:

• query: Search query
• limit: Maximum number of results (default: 10)

This server is configured to be published to the Cline MCP Marketplace using the GitHub repository at: https://github.com/kompallik/ATLASSIAN-MCP

To publish updates:

1. Push your changes to the GitHub repository using the provided script:

npm run push-github

1. Add an icon.png file in the assets directory if not already present
2. Run the publish script:

npm run publish-mcp

1. Follow the prompts to publish to npm and/or create a distribution package
2. Submit your repository URL to the Cline MCP Marketplace team

MIT