AnoushkaSScaria/local_atlass_mcp_server
If you are the rightful owner of local_atlass_mcp_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Atlass MCP Server is a modular and efficient server designed to integrate with Atlassian's Jira and Confluence platforms, providing seamless API operations and enhanced project management capabilities.
Prerequisites: - Python 3.10 with required dependencies - Atlassian account with access to Jira and Confluence - API tokens for both Jira and Confluence
Installation: - install uv: - powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" - install fastmcp: - pip install fastmcp httpx - install requirements: - pip install -r requirements.txt - install boto3 - uv pip install boto3
Configuration: - You need to add a .env file with the following environment variables: - JIRA_EMAIL = "your.account@onedatascan.com" - JIRA_API_TOKEN = "your_jira_api_token_here" - CONFLUENCE_API_TOKEN = "your_confluence_api_token_here"
Run the client and server with: - cd into atlass_mcp_server directory - uv run path_to_atlass_client.py "run_local.py"
Refactored Atlass MCP Server Structure: atlass_mcp_server/ āāā server.py # Entry point for MCP server āāā config.py # Configuration and environment variables āāā auth.py # Authentication utilities āāā http_client.py # HTTP client utilities for making API requests. āāā jira_service.py # Jira service for handling Jira API operations.n āāā jira_utils.py # Utility functions for working with Jira data. āāā confluence_service.py # Service for handling Confluence API operations. āāā run_local.py # Local development runner for MCP server. āāā requirements.txt # Python dependencies āāā pyproject.toml # Project metadata āāā uv.lock # Lock file āāā README.md # Project documentation
Notes:
- All business logic is split into focused modules for maintainability.
- Add any shared utility functions to the `utils/` folder.
- Update imports if you add new modules.
Available tools: 1. get_jira_ticket - Fetches comprehensive details for a Jira issue including child stories and subtasks. - Parameters: - issue_key (str): Jira issue key (e.g., "PROJ-123") - Returns: Formatted string with issue details, status, reporter, description, and all subtasks.
2. create_confluence_page
- Creates a new page in Confluence with specified content.
- Parameters:
- space_key (str): Confluence space key
- title (str): Page title
- body (str): HTML content for the page
- Returns: Success message with page URL or error description.
3. create_test_plan_from_jira
- Creates or updates a Confluence page with a test plan based on Jira ticket data.
- Parameters:
- issue_key (str): Jira issue key for reference
- confluence_space_key (str): Confluence space key
- confluence_title (str): Title for the page
- test_plan (str): Complete test plan content in HTML
- Returns: Success message with page URL or error description.