et-devops-mcp-atlassian 1.0__tar.gz

et_devops_mcp_atlassian-1.0/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: et-devops-mcp-atlassian
+Version: 1.0
+Summary: MCP server for Jira and Confluence Data Center — Kubernetes-ready
+Author: ET AI Solutions
+Maintainer: ET AI Solutions
+Requires-Python: <3.14,>=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp<3.0.0,>=2.14.1
+Requires-Dist: mcp<2.0.0,>=1.8.0
+Requires-Dist: atlassian-python-api>=4.0.0
+Requires-Dist: requests[socks]>=2.31.0
+Requires-Dist: beautifulsoup4>=4.12.3
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: markdownify>=0.11.6
+Requires-Dist: markdown>=3.7.0
+Requires-Dist: markdown-to-confluence<0.4.0,>=0.3.4
+Requires-Dist: pydantic<3.0,>=2.10.6
+Requires-Dist: python-dateutil>=2.9.0.post0
+Requires-Dist: types-python-dateutil>=2.9.0.20241206
+Requires-Dist: unidecode>=1.3.0
+Requires-Dist: thefuzz>=0.22.1
+Requires-Dist: uvicorn>=0.27.1
+Requires-Dist: starlette>=0.49.1
+Requires-Dist: fastapi>=0.124.4
+Requires-Dist: aiohttp>=3.13.2
+Requires-Dist: urllib3>=2.6.3
+Requires-Dist: keyring>=25.6.0
+Requires-Dist: truststore>=0.10.0
+Requires-Dist: cachetools>=5.0.0
+Requires-Dist: types-cachetools>=5.5.0.20240820
+Requires-Dist: click>=8.1.7
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: trio>=0.29.0
+Requires-Dist: prometheus-fastapi-instrumentator>=7.1.0
+Requires-Dist: psutil>=7.1.3
+Requires-Dist: fakeredis<2.35.0,>=2.32.1
+Requires-Dist: tzdata>=2024.1; platform_system == "Windows"
+
+# et-devops-mcp-atlassian-dc
+
+MCP server for Atlassian Data Center — exposes Jira and Confluence operations as tools for AI assistants.
+
+## Overview
+
+Provides Jira and Confluence tools via the [Model Context Protocol](https://modelcontextprotocol.io). Authentication is per-call using a Personal Access Token (PAT) passed directly as a tool argument.
+
+## Tools
+
+### Jira (60 tools)
+
+| Toolset | Tool | Description |
+|---|---|---|
+| `jira_issues` | `jira_get_issue` | Get issue details by key |
+| `jira_issues` | `jira_search` | Search issues using JQL |
+| `jira_issues` | `jira_create_issue` | Create a new issue |
+| `jira_issues` | `jira_update_issue` | Update an existing issue |
+| `jira_issues` | `jira_batch_create_issues` | Bulk-create issues |
+| `jira_issues` | `jira_batch_get_changelogs` | Get changelogs for multiple issues |
+| `jira_comments` | `jira_add_comment` | Add a comment to an issue |
+| `jira_comments` | `jira_edit_comment` | Edit an existing comment |
+| `jira_fields` | `jira_search_fields` | Search available fields |
+| `jira_fields` | `jira_get_field_options` | Get options for a field |
+| `jira_transitions` | `jira_get_transitions` | Get available transitions for an issue |
+| `jira_transitions` | `jira_transition_issue` | Move an issue to a new status |
+| `jira_projects` | `jira_get_all_projects` | List all accessible projects |
+| `jira_projects` | `jira_get_project_issues` | List issues in a project |
+| `jira_projects` | `jira_get_project_versions` | List versions for a project |
+| `jira_projects` | `jira_get_project_components` | List components for a project |
+| `jira_projects` | `jira_get_project_issue_types` | List issue types for a project |
+| `jira_projects` | `jira_create_version` | Create a project version |
+| `jira_projects` | `jira_batch_create_versions` | Bulk-create project versions |
+| `jira_agile` | `jira_get_agile_boards` | List agile boards |
+| `jira_agile` | `jira_get_board_issues` | List issues on a board |
+| `jira_agile` | `jira_get_sprints_from_board` | List sprints for a board |
+| `jira_agile` | `jira_get_sprint_issues` | List issues in a sprint |
+| `jira_agile` | `jira_create_sprint` | Create a sprint |
+| `jira_agile` | `jira_update_sprint` | Update a sprint |
+| `jira_agile` | `jira_add_issues_to_sprint` | Add issues to a sprint |
+| `jira_links` | `jira_get_link_types` | List issue link types |
+| `jira_links` | `jira_create_issue_link` | Link two issues |
+| `jira_links` | `jira_create_remote_issue_link` | Create a remote issue link |
+| `jira_links` | `jira_remove_issue_link` | Remove an issue link |
+| `jira_links` | `jira_link_to_epic` | Link an issue to an epic |
+| `jira_worklog` | `jira_get_worklog` | Get worklogs for an issue |
+| `jira_worklog` | `jira_add_worklog` | Log time on an issue |
+| `jira_attachments` | `jira_download_attachments` | Download issue attachments |
+| `jira_attachments` | `jira_get_issue_images` | Get images from an issue |
+| `jira_users` | `jira_get_user_profile` | Get a user's profile |
+| `jira_users` | `jira_search_users` | Search users by name, username, or email |
+| `jira_watchers` | `jira_get_issue_watchers` | List watchers on an issue |
+| `jira_watchers` | `jira_add_watcher` | Add a watcher to an issue |
+| `jira_watchers` | `jira_remove_watcher` | Remove a watcher from an issue |
+| `jira_service_desk` | `jira_get_service_desk_for_project` | Get service desk for a project |
+| `jira_service_desk` | `jira_get_service_desk_queues` | List queues for a service desk |
+| `jira_service_desk` | `jira_get_queue_issues` | List issues in a queue |
+| `jira_service_desk` | `jira_get_request_types` | List request types for a service desk |
+| `jira_service_desk` | `jira_get_request_type_fields` | Get fields for a request type |
+| `jira_service_desk` | `jira_get_approvals` | List approvals for a service desk issue |
+| `jira_service_desk` | `jira_get_approval` | Get a specific approval |
+| `jira_service_desk` | `jira_answer_approval` | Approve or decline a pending approval |
+| `jira_filters` | `jira_get_filter` | Get a saved JQL filter by ID |
+| `jira_filters` | `jira_create_filter` | Create a saved JQL filter |
+| `jira_filters` | `jira_update_filter` | Update a saved JQL filter |
+| `jira_metrics` | `jira_get_issue_dates` | Get date fields for an issue |
+| `jira_metrics` | `jira_get_issue_sla` | Get SLA metrics for a service desk issue |
+| `jira_development` | `jira_get_issue_development_info` | Get dev info (branches, PRs, commits) for an issue |
+| `jira_development` | `jira_get_issues_development_info` | Get dev info for multiple issues |
+| `jira_configuration` | `jira_get_configuration` | Get global Jira configuration |
+| `jira_configuration` | `jira_get_server_info` | Get server version and deployment type |
+| `jira_configuration` | `jira_get_all_priorities` | List all configured priorities |
+| `jira_configuration` | `jira_get_all_resolutions` | List all configured resolutions |
+| `jira_configuration` | `jira_get_all_statuses` | List all configured statuses |
+
+### Confluence (25 tools)
+
+| Toolset | Tool | Description |
+|---|---|---|
+| `confluence_pages` | `confluence_search` | Search pages using CQL |
+| `confluence_pages` | `confluence_get_page` | Get page content by ID |
+| `confluence_pages` | `confluence_get_page_children` | List child pages |
+| `confluence_pages` | `confluence_get_space_page_tree` | Get page tree for a space |
+| `confluence_pages` | `confluence_create_page` | Create a new page |
+| `confluence_pages` | `confluence_update_page` | Update an existing page |
+| `confluence_pages` | `confluence_move_page` | Move a page to a new parent |
+| `confluence_pages` | `confluence_get_page_history` | Get revision history for a page |
+| `confluence_pages` | `confluence_get_page_diff` | Get diff between page versions |
+| `confluence_comments` | `confluence_get_comments` | Get comments on a page |
+| `confluence_comments` | `confluence_add_comment` | Add a comment to a page |
+| `confluence_comments` | `confluence_reply_to_comment` | Reply to an existing comment |
+| `confluence_labels` | `confluence_get_labels` | Get labels on a page |
+| `confluence_labels` | `confluence_add_label` | Add a label to a page |
+| `confluence_users` | `confluence_search_user` | Search Confluence users |
+| `confluence_analytics` | `confluence_get_page_views` | Get view analytics for a page |
+| `confluence_attachments` | `confluence_upload_attachment` | Upload a single attachment |
+| `confluence_attachments` | `confluence_upload_attachments` | Upload multiple attachments |
+| `confluence_attachments` | `confluence_get_attachments` | List attachments on a page |
+| `confluence_attachments` | `confluence_download_attachment` | Download an attachment |
+| `confluence_attachments` | `confluence_download_content_attachments` | Download all attachments for a page |
+| `confluence_attachments` | `confluence_get_page_images` | Get images from a page |
+| `confluence_spaces` | `confluence_get_spaces` | List accessible spaces |
+| `confluence_spaces` | `confluence_get_space` | Get a space by key |
+| `confluence_spaces` | `confluence_get_page_restrictions` | Get content restrictions for a page |
+
+## MCP Client Configuration
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "atlassian_dc": {
+      "type": "http",
+      "url": "https://gateway-dev.mcp.zurich.com/servers/7bf9b1c86d3b4dd9b087f82b26406a9a/mcp",
+      "headers": {
+        "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJqb3NlYW5nZWwubXVub3pAenVyaWNoLmNvbSIsImp0aSI6IjBmNGNiZWQ3LTdiYjYtNDYzNC1hYjQ3LWQ3ZjZhODk3MTRkNyIsInRva2VuX3VzZSI6ImFwaSIsImlhdCI6MTc4MTAwNzgxMywiaXNzIjoienVyaWNoIiwiYXVkIjoibWNwZ2F0ZXdheS1hcGkiLCJ1c2VyIjp7ImVtYWlsIjoiam9zZWFuZ2VsLm11bm96QHp1cmljaC5jb20iLCJmdWxsX25hbWUiOiJBUEkgVG9rZW4gVXNlciIsImlzX2FkbWluIjp0cnVlLCJhdXRoX3Byb3ZpZGVyIjoiYXBpX3Rva2VuIn0sInRlYW1zIjpudWxsLCJzY29wZXMiOnsic2VydmVyX2lkIjoiN2JmOWIxYzg2ZDNiNGRkOWIwODdmODJiMjY0MDZhOWEiLCJwZXJtaXNzaW9ucyI6W10sImlwX3Jlc3RyaWN0aW9ucyI6W10sInRpbWVfcmVzdHJpY3Rpb25zIjp7fX0sImV4cCI6MTgxMjU0MzgxM30.8wg6CIIYco5rvjscrcrpFL8kYW0hMVKSOznE2N9DuEM"
+      }
+    }
+  }
+}
+```
+
+> PATs are not configured here — the AI assistant will ask for them when needed and pass them as tool arguments on each call.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `ATLASSIAN_DC_JIRA_URL` | Yes | Jira base URL |
+| `ATLASSIAN_DC_CONFLUENCE_URL` | Yes | Confluence base URL |
+| `ATLASSIAN_OAUTH_ENABLE` | No | Enable OAuth mode |
+| `TOOLSETS` | No | Comma-separated toolset names, `all`, or `default` |
+| `READ_ONLY` | No | Disable all write tools |
+| `LOG_LEVEL` | No | Logging level (default: `INFO`) |
+

et_devops_mcp_atlassian-1.0/README.md

@@ -0,0 +1,136 @@
+# et-devops-mcp-atlassian-dc
+
+MCP server for Atlassian Data Center — exposes Jira and Confluence operations as tools for AI assistants.
+
+## Overview
+
+Provides Jira and Confluence tools via the [Model Context Protocol](https://modelcontextprotocol.io). Authentication is per-call using a Personal Access Token (PAT) passed directly as a tool argument.
+
+## Tools
+
+### Jira (60 tools)
+
+| Toolset | Tool | Description |
+|---|---|---|
+| `jira_issues` | `jira_get_issue` | Get issue details by key |
+| `jira_issues` | `jira_search` | Search issues using JQL |
+| `jira_issues` | `jira_create_issue` | Create a new issue |
+| `jira_issues` | `jira_update_issue` | Update an existing issue |
+| `jira_issues` | `jira_batch_create_issues` | Bulk-create issues |
+| `jira_issues` | `jira_batch_get_changelogs` | Get changelogs for multiple issues |
+| `jira_comments` | `jira_add_comment` | Add a comment to an issue |
+| `jira_comments` | `jira_edit_comment` | Edit an existing comment |
+| `jira_fields` | `jira_search_fields` | Search available fields |
+| `jira_fields` | `jira_get_field_options` | Get options for a field |
+| `jira_transitions` | `jira_get_transitions` | Get available transitions for an issue |
+| `jira_transitions` | `jira_transition_issue` | Move an issue to a new status |
+| `jira_projects` | `jira_get_all_projects` | List all accessible projects |
+| `jira_projects` | `jira_get_project_issues` | List issues in a project |
+| `jira_projects` | `jira_get_project_versions` | List versions for a project |
+| `jira_projects` | `jira_get_project_components` | List components for a project |
+| `jira_projects` | `jira_get_project_issue_types` | List issue types for a project |
+| `jira_projects` | `jira_create_version` | Create a project version |
+| `jira_projects` | `jira_batch_create_versions` | Bulk-create project versions |
+| `jira_agile` | `jira_get_agile_boards` | List agile boards |
+| `jira_agile` | `jira_get_board_issues` | List issues on a board |
+| `jira_agile` | `jira_get_sprints_from_board` | List sprints for a board |
+| `jira_agile` | `jira_get_sprint_issues` | List issues in a sprint |
+| `jira_agile` | `jira_create_sprint` | Create a sprint |
+| `jira_agile` | `jira_update_sprint` | Update a sprint |
+| `jira_agile` | `jira_add_issues_to_sprint` | Add issues to a sprint |
+| `jira_links` | `jira_get_link_types` | List issue link types |
+| `jira_links` | `jira_create_issue_link` | Link two issues |
+| `jira_links` | `jira_create_remote_issue_link` | Create a remote issue link |
+| `jira_links` | `jira_remove_issue_link` | Remove an issue link |
+| `jira_links` | `jira_link_to_epic` | Link an issue to an epic |
+| `jira_worklog` | `jira_get_worklog` | Get worklogs for an issue |
+| `jira_worklog` | `jira_add_worklog` | Log time on an issue |
+| `jira_attachments` | `jira_download_attachments` | Download issue attachments |
+| `jira_attachments` | `jira_get_issue_images` | Get images from an issue |
+| `jira_users` | `jira_get_user_profile` | Get a user's profile |
+| `jira_users` | `jira_search_users` | Search users by name, username, or email |
+| `jira_watchers` | `jira_get_issue_watchers` | List watchers on an issue |
+| `jira_watchers` | `jira_add_watcher` | Add a watcher to an issue |
+| `jira_watchers` | `jira_remove_watcher` | Remove a watcher from an issue |
+| `jira_service_desk` | `jira_get_service_desk_for_project` | Get service desk for a project |
+| `jira_service_desk` | `jira_get_service_desk_queues` | List queues for a service desk |
+| `jira_service_desk` | `jira_get_queue_issues` | List issues in a queue |
+| `jira_service_desk` | `jira_get_request_types` | List request types for a service desk |
+| `jira_service_desk` | `jira_get_request_type_fields` | Get fields for a request type |
+| `jira_service_desk` | `jira_get_approvals` | List approvals for a service desk issue |
+| `jira_service_desk` | `jira_get_approval` | Get a specific approval |
+| `jira_service_desk` | `jira_answer_approval` | Approve or decline a pending approval |
+| `jira_filters` | `jira_get_filter` | Get a saved JQL filter by ID |
+| `jira_filters` | `jira_create_filter` | Create a saved JQL filter |
+| `jira_filters` | `jira_update_filter` | Update a saved JQL filter |
+| `jira_metrics` | `jira_get_issue_dates` | Get date fields for an issue |
+| `jira_metrics` | `jira_get_issue_sla` | Get SLA metrics for a service desk issue |
+| `jira_development` | `jira_get_issue_development_info` | Get dev info (branches, PRs, commits) for an issue |
+| `jira_development` | `jira_get_issues_development_info` | Get dev info for multiple issues |
+| `jira_configuration` | `jira_get_configuration` | Get global Jira configuration |
+| `jira_configuration` | `jira_get_server_info` | Get server version and deployment type |
+| `jira_configuration` | `jira_get_all_priorities` | List all configured priorities |
+| `jira_configuration` | `jira_get_all_resolutions` | List all configured resolutions |
+| `jira_configuration` | `jira_get_all_statuses` | List all configured statuses |
+
+### Confluence (25 tools)
+
+| Toolset | Tool | Description |
+|---|---|---|
+| `confluence_pages` | `confluence_search` | Search pages using CQL |
+| `confluence_pages` | `confluence_get_page` | Get page content by ID |
+| `confluence_pages` | `confluence_get_page_children` | List child pages |
+| `confluence_pages` | `confluence_get_space_page_tree` | Get page tree for a space |
+| `confluence_pages` | `confluence_create_page` | Create a new page |
+| `confluence_pages` | `confluence_update_page` | Update an existing page |
+| `confluence_pages` | `confluence_move_page` | Move a page to a new parent |
+| `confluence_pages` | `confluence_get_page_history` | Get revision history for a page |
+| `confluence_pages` | `confluence_get_page_diff` | Get diff between page versions |
+| `confluence_comments` | `confluence_get_comments` | Get comments on a page |
+| `confluence_comments` | `confluence_add_comment` | Add a comment to a page |
+| `confluence_comments` | `confluence_reply_to_comment` | Reply to an existing comment |
+| `confluence_labels` | `confluence_get_labels` | Get labels on a page |
+| `confluence_labels` | `confluence_add_label` | Add a label to a page |
+| `confluence_users` | `confluence_search_user` | Search Confluence users |
+| `confluence_analytics` | `confluence_get_page_views` | Get view analytics for a page |
+| `confluence_attachments` | `confluence_upload_attachment` | Upload a single attachment |
+| `confluence_attachments` | `confluence_upload_attachments` | Upload multiple attachments |
+| `confluence_attachments` | `confluence_get_attachments` | List attachments on a page |
+| `confluence_attachments` | `confluence_download_attachment` | Download an attachment |
+| `confluence_attachments` | `confluence_download_content_attachments` | Download all attachments for a page |
+| `confluence_attachments` | `confluence_get_page_images` | Get images from a page |
+| `confluence_spaces` | `confluence_get_spaces` | List accessible spaces |
+| `confluence_spaces` | `confluence_get_space` | Get a space by key |
+| `confluence_spaces` | `confluence_get_page_restrictions` | Get content restrictions for a page |
+
+## MCP Client Configuration
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "atlassian_dc": {
+      "type": "http",
+      "url": "https://gateway-dev.mcp.zurich.com/servers/7bf9b1c86d3b4dd9b087f82b26406a9a/mcp",
+      "headers": {
+        "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJqb3NlYW5nZWwubXVub3pAenVyaWNoLmNvbSIsImp0aSI6IjBmNGNiZWQ3LTdiYjYtNDYzNC1hYjQ3LWQ3ZjZhODk3MTRkNyIsInRva2VuX3VzZSI6ImFwaSIsImlhdCI6MTc4MTAwNzgxMywiaXNzIjoienVyaWNoIiwiYXVkIjoibWNwZ2F0ZXdheS1hcGkiLCJ1c2VyIjp7ImVtYWlsIjoiam9zZWFuZ2VsLm11bm96QHp1cmljaC5jb20iLCJmdWxsX25hbWUiOiJBUEkgVG9rZW4gVXNlciIsImlzX2FkbWluIjp0cnVlLCJhdXRoX3Byb3ZpZGVyIjoiYXBpX3Rva2VuIn0sInRlYW1zIjpudWxsLCJzY29wZXMiOnsic2VydmVyX2lkIjoiN2JmOWIxYzg2ZDNiNGRkOWIwODdmODJiMjY0MDZhOWEiLCJwZXJtaXNzaW9ucyI6W10sImlwX3Jlc3RyaWN0aW9ucyI6W10sInRpbWVfcmVzdHJpY3Rpb25zIjp7fX0sImV4cCI6MTgxMjU0MzgxM30.8wg6CIIYco5rvjscrcrpFL8kYW0hMVKSOznE2N9DuEM"
+      }
+    }
+  }
+}
+```
+
+> PATs are not configured here — the AI assistant will ask for them when needed and pass them as tool arguments on each call.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `ATLASSIAN_DC_JIRA_URL` | Yes | Jira base URL |
+| `ATLASSIAN_DC_CONFLUENCE_URL` | Yes | Confluence base URL |
+| `ATLASSIAN_OAUTH_ENABLE` | No | Enable OAuth mode |
+| `TOOLSETS` | No | Comma-separated toolset names, `all`, or `default` |
+| `READ_ONLY` | No | Disable all write tools |
+| `LOG_LEVEL` | No | Logging level (default: `INFO`) |
+

et_devops_mcp_atlassian-1.0/app/__main__.py

@@ -0,0 +1,35 @@
+import os
+
+from dotenv import load_dotenv
+
+load_dotenv(override=False)
+
+if not os.getenv("JIRA_URL") and os.getenv("ATLASSIAN_DC_JIRA_URL"):
+    os.environ["JIRA_URL"] = os.getenv("ATLASSIAN_DC_JIRA_URL") or ""
+if not os.getenv("CONFLUENCE_URL") and os.getenv("ATLASSIAN_DC_CONFLUENCE_URL"):
+    os.environ["CONFLUENCE_URL"] = os.getenv("ATLASSIAN_DC_CONFLUENCE_URL") or ""
+
+from app.core import tools  # noqa: E402
+from app.core.server import create_mcp  # noqa: E402
+
+
+def main() -> None:
+    mcp = create_mcp(
+        name="Atlassian MCP",
+        instructions="""
+            This server provides tools to interact with Atlassian Jira and Confluence.
+
+            AUTHENTICATION: Every Jira tool requires a jira_pat parameter and every Confluence tool requires a confluence_pat parameter.
+            Jira and Confluence are separate systems and always require separate PATs — never reuse a Jira PAT for Confluence or vice versa.
+            Ask the user for the relevant PAT before calling any tool, then pass it in every call.
+
+            Use the Jira tools to manage issues, projects, sprints, and workflows.
+            Use the Confluence tools to search, read, and manage pages and spaces.
+        """,
+    )
+    mcp.mount(tools.mcp)
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

et_devops_mcp_atlassian-1.0/app/confluence/__init__.py

@@ -0,0 +1,52 @@
+"""Confluence API integration module.
+
+This module provides access to Confluence content through the Model Context Protocol.
+"""
+
+from .analytics import AnalyticsMixin
+from .attachments import AttachmentsMixin
+from .client import ConfluenceClient
+from .comments import CommentsMixin
+from .config import ConfluenceConfig
+from .labels import LabelsMixin
+from .pages import PagesMixin
+from .search import SearchMixin
+from .spaces import SpacesMixin
+from .users import UsersMixin
+
+
+class ConfluenceFetcher(
+    SearchMixin,
+    SpacesMixin,
+    PagesMixin,
+    CommentsMixin,
+    LabelsMixin,
+    UsersMixin,
+    AnalyticsMixin,
+    AttachmentsMixin,
+):
+    """Main entry point for Confluence operations, providing backward compatibility.
+
+    This class combines functionality from various mixins to maintain the same
+    API as the original ConfluenceFetcher class.
+
+    Available mixins:
+    - SearchMixin: CQL search operations
+    - SpacesMixin: Space operations
+    - PagesMixin: Page operations
+    - CommentsMixin: Comment operations
+    - LabelsMixin: Label operations
+    - UsersMixin: User operations
+    - AnalyticsMixin: Page view analytics (Cloud only)
+    - AttachmentsMixin: Attachment operations
+    """
+
+    pass
+
+
+__all__ = [
+    "ConfluenceFetcher",
+    "ConfluenceConfig",
+    "ConfluenceClient",
+    "AnalyticsMixin",
+]

et_devops_mcp_atlassian-1.0/app/confluence/analytics.py

@@ -0,0 +1,173 @@
+"""Analytics mixin for Confluence page view statistics.
+
+This module provides functionality to retrieve page view statistics
+from Confluence Cloud using the Analytics API.
+
+Note: The Analytics API is only available for Confluence Cloud.
+Server/Data Center instances do not support this API.
+"""
+
+import logging
+from datetime import datetime
+from typing import Any
+
+from requests.exceptions import HTTPError
+
+from ..models.confluence.analytics import PageViews, PageViewsBatchResponse
+
+logger = logging.getLogger("mcp-atlassian")
+
+
+class AnalyticsMixin:
+    """Mixin providing Confluence page view analytics functionality.
+
+    This mixin requires the class to have:
+    - self.confluence: Atlassian Confluence client
+    - self.config: ConfluenceConfig instance
+    - self.v2_adapter: Optional ConfluenceV2Adapter for OAuth
+    """
+
+    # Type hints for attributes expected from the base class
+    confluence: Any
+    config: Any
+    v2_adapter: Any
+
+    def get_page_views(
+        self,
+        page_id: str,
+        include_title: bool = True,
+    ) -> PageViews:
+        """Get view statistics for a Confluence page.
+
+        Note: This API is only available for Confluence Cloud.
+
+        Args:
+            page_id: The ID of the page
+            include_title: Whether to fetch and include the page title
+
+        Returns:
+            PageViews with view statistics
+
+        Raises:
+            ValueError: If the page is not found or API fails
+            HTTPError: If authentication fails (401/403 are propagated)
+        """
+        if not self.config.is_cloud:
+            raise ValueError(
+                "Page view analytics is only available for Confluence Cloud. "
+                "Server/Data Center instances do not support the Analytics API."
+            )
+
+        # Get page title if requested
+        page_title = None
+        if include_title:
+            try:
+                page_info = self.confluence.get_page_by_id(page_id, expand="title")
+                page_title = page_info.get("title")
+            except Exception as e:
+                logger.warning(f"Could not fetch title for page {page_id}: {e}")
+
+        # Get view statistics using v2 adapter or direct API
+        try:
+            if hasattr(self, "v2_adapter") and self.v2_adapter:
+                views_data = self.v2_adapter.get_page_views(page_id)
+            else:
+                views_data = self._get_page_views_direct(page_id)
+
+            # Parse the response
+            total_views = views_data.get("count", 0)
+
+            # Parse last viewed timestamp if available
+            last_viewed = None
+            last_seen_str = views_data.get("lastSeen")
+            if last_seen_str:
+                try:
+                    # Try parsing ISO format timestamp
+                    last_viewed = datetime.fromisoformat(
+                        last_seen_str.replace("Z", "+00:00")
+                    )
+                except (ValueError, AttributeError):
+                    pass
+
+            return PageViews(
+                page_id=page_id,
+                page_title=page_title,
+                total_views=total_views,
+                last_viewed=last_viewed,
+            )
+
+        except HTTPError as e:
+            # Propagate auth errors
+            if e.response is not None and e.response.status_code in [401, 403]:
+                raise
+            logger.warning(f"Failed to get views for page {page_id}: {e}")
+            # Return zero views on error (non-auth)
+            return PageViews(
+                page_id=page_id,
+                page_title=page_title,
+                total_views=0,
+            )
+        except Exception as e:
+            logger.warning(f"Unexpected error getting views for page {page_id}: {e}")
+            return PageViews(
+                page_id=page_id,
+                page_title=page_title,
+                total_views=0,
+            )
+
+    def _get_page_views_direct(
+        self,
+        page_id: str,
+    ) -> dict:
+        """Get page views using direct API call.
+
+        Args:
+            page_id: The ID of the page
+
+        Returns:
+            Dictionary with view statistics
+
+        Raises:
+            HTTPError: If the API request fails
+        """
+        url = f"{self.confluence.url}/rest/api/analytics/content/{page_id}/views"
+        response = self.confluence._session.get(url)
+        response.raise_for_status()
+        return response.json()
+
+    def batch_get_page_views(
+        self,
+        page_ids: list[str],
+        include_title: bool = True,
+    ) -> PageViewsBatchResponse:
+        """Get view statistics for multiple pages.
+
+        Args:
+            page_ids: List of page IDs
+            include_title: Whether to fetch and include page titles
+
+        Returns:
+            PageViewsBatchResponse with results for all pages
+        """
+        pages: list[PageViews] = []
+        errors: list[dict[str, str]] = []
+
+        for page_id in page_ids:
+            try:
+                page_views = self.get_page_views(page_id, include_title=include_title)
+                pages.append(page_views)
+            except HTTPError as e:
+                # Propagate auth errors
+                if e.response is not None and e.response.status_code in [401, 403]:
+                    raise
+                errors.append({"page_id": page_id, "error": str(e)})
+            except Exception as e:
+                errors.append({"page_id": page_id, "error": str(e)})
+
+        return PageViewsBatchResponse(
+            pages=pages,
+            total_count=len(page_ids),
+            success_count=len(pages),
+            error_count=len(errors),
+            errors=errors,
+        )