{"_id":"mcp-atlassian","_rev":"4-22df99340b02486110d8c6fa864eee50","name":"mcp-atlassian","dist-tags":{"latest":"2.1.0"},"versions":{"2.0.0":{"name":"mcp-atlassian","version":"2.0.0","keywords":["mcp","atlassian","confluence","jira","model-context-protocol","ai-assistant","claude"],"author":{"name":"MCP Atlassian Contributors"},"license":"MIT","_id":"mcp-atlassian@2.0.0","maintainers":[{"name":"vijay_duke","email":"Mail@VijayIyengar.com"}],"homepage":"https://github.com/Vijay-Duke/mcp-atlassian#readme","bugs":{"url":"https://github.com/Vijay-Duke/mcp-atlassian/issues"},"bin":{"mcp-atlassian":"dist/index.js"},"dist":{"shasum":"9819a5da9785eccc96b04611d27c9c2066632d71","tarball":"https://registry.npmjs.org/mcp-atlassian/-/mcp-atlassian-2.0.0.tgz","fileCount":32,"integrity":"sha512-1bPsFqV25ACJ2IAPISRETHCEkTn8tbeL8/kJTMtq6NEyF7p8UEgvSkVyO1DUhRKiAqf1+9+n+fmMPGvSg8eepw==","signatures":[{"sig":"MEQCIG27Muww5Skr27ashQQ9uiA/jQ3m+FK7/fbuj9HaciY/AiB/5qm25i6mAq1AIRpHhZ81wivSHQ28vEe87Y8RLpLSQw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":135233},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"569abf75c9697cd5f5d5ceafd9d99d6a6dc04bbb","scripts":{"dev":"tsx src/index.ts","test":"vitest","build":"tsc","start":"node dist/index.js","test:ui":"vitest --ui","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"vijay_duke","email":"Mail@VijayIyengar.com"},"repository":{"url":"git+https://github.com/Vijay-Duke/mcp-atlassian.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Atlassian (Confluence and Jira) integration","directories":{},"_nodeVersion":"22.17.1","dependencies":{"axios":"^1.11.0","dotenv":"^17.2.0","https-proxy-agent":"^7.0.6","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"c8":"^10.1.3","tsx":"^4.20.3","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.8.3","@types/node":"^24.1.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-atlassian_2.0.0_1754833359343_0.4383651572648106","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"mcp-atlassian","version":"2.0.1","keywords":["mcp","atlassian","confluence","jira","model-context-protocol","ai-assistant","claude"],"author":{"name":"MCP Atlassian Contributors"},"license":"MIT","_id":"mcp-atlassian@2.0.1","maintainers":[{"name":"vijay_duke","email":"Mail@VijayIyengar.com"}],"homepage":"https://github.com/Vijay-Duke/mcp-atlassian#readme","bugs":{"url":"https://github.com/Vijay-Duke/mcp-atlassian/issues"},"bin":{"mcp-atlassian":"dist/index.js"},"dist":{"shasum":"e7af123581551512495b1c1caf4610723080211a","tarball":"https://registry.npmjs.org/mcp-atlassian/-/mcp-atlassian-2.0.1.tgz","fileCount":44,"integrity":"sha512-JrDayvfiNfR35v8o9eLx2Tf+TfzyTOqR+c9jqhtorzJBP6A1JCgSlEK4obTaiuVnngChKZiSg5XJsrr8icw3lg==","signatures":[{"sig":"MEYCIQCwFt9BhG5Nzaa5J/uuKXsfzqSd/Y87zbzAqL2HsuvnVwIhAPrRBp1Ovy3Ii7bmXEtKzM8BFFejhpQKVzdD9iyXioFs","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":299272},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"c524b9c8718ead07c48894f1fb238630f0b413a7","scripts":{"dev":"tsx src/index.ts","test":"vitest","build":"tsc","start":"node dist/index.js","test:ui":"vitest --ui","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"vijay_duke","email":"Mail@VijayIyengar.com"},"repository":{"url":"git+https://github.com/Vijay-Duke/mcp-atlassian.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Atlassian (Confluence and Jira) integration","directories":{},"_nodeVersion":"22.17.1","dependencies":{"axios":"^1.11.0","dotenv":"^17.2.0","form-data":"^4.0.4","@types/form-data":"^2.2.1","https-proxy-agent":"^7.0.6","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"c8":"^10.1.3","tsx":"^4.20.3","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.8.3","@types/node":"^24.1.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-atlassian_2.0.1_1754837706134_0.5926213664979167","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"mcp-atlassian","version":"2.0.2","keywords":["mcp","atlassian","confluence","jira","model-context-protocol","ai-assistant","claude"],"author":{"name":"MCP Atlassian Contributors"},"license":"MIT","_id":"mcp-atlassian@2.0.2","maintainers":[{"name":"vijay_duke","email":"Mail@VijayIyengar.com"}],"homepage":"https://github.com/Vijay-Duke/mcp-atlassian#readme","bugs":{"url":"https://github.com/Vijay-Duke/mcp-atlassian/issues"},"bin":{"mcp-atlassian":"dist/index.js"},"dist":{"shasum":"5937ef59b399aa42f83e1c8205e8c0531602087a","tarball":"https://registry.npmjs.org/mcp-atlassian/-/mcp-atlassian-2.0.2.tgz","fileCount":46,"integrity":"sha512-IUm6AZ9C33kx/+09Osj49FaLwH2ikLVm36D5Y/b8on/7izk5SqiqPeXskVJ/y2NjxpEWD2kGbwu2lPw5fJxtjw==","signatures":[{"sig":"MEUCIA6PVPiPSPqC+lVhfNPy6AVEbdAF17wks2SaJfWXhCJtAiEAqrUXh9XC3JpxR5kbqEBG0RQVfXqaPw9v/098XC0N+zI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":328847},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b0a4dbef3bf911e71f15de2654ef4a2c23b892ca","scripts":{"dev":"tsx src/index.ts","test":"vitest","build":"tsc","start":"node dist/index.js","test:ui":"vitest --ui","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"vijay_duke","email":"Mail@VijayIyengar.com"},"repository":{"url":"git+https://github.com/Vijay-Duke/mcp-atlassian.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Atlassian (Confluence and Jira) integration","directories":{},"_nodeVersion":"22.17.1","dependencies":{"axios":"^1.11.0","dotenv":"^17.2.0","dompurify":"^3.2.6","form-data":"^4.0.4","@types/form-data":"^2.2.1","https-proxy-agent":"^7.0.6","@modelcontextprotocol/sdk":"^1.16.0"},"_hasShrinkwrap":false,"devDependencies":{"c8":"^10.1.3","tsx":"^4.20.3","jsdom":"^21.1.2","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.8.3","@types/node":"^24.1.0","@types/jsdom":"^21.1.7","@types/dompurify":"^3.0.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-atlassian_2.0.2_1754865642044_0.8322501634045507","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"mcp-atlassian","version":"2.1.0","description":"MCP server for Atlassian (Confluence and Jira) integration","main":"dist/index.js","type":"module","bin":{"mcp-atlassian":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","test":"vitest","test:ui":"vitest --ui","test:coverage":"vitest run --coverage","lint":"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix","format":"prettier --write \"src/**/*.{ts,js,json,md}\"","format:check":"prettier --check \"src/**/*.{ts,js,json,md}\"","check":"npm run format:check && npm run lint && npm run test","fix":"npm run format && npm run lint:fix"},"keywords":["mcp","atlassian","confluence","jira","model-context-protocol","ai-assistant","claude"],"author":{"name":"MCP Atlassian Contributors"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Vijay-Duke/mcp-atlassian.git"},"homepage":"https://github.com/Vijay-Duke/mcp-atlassian#readme","bugs":{"url":"https://github.com/Vijay-Duke/mcp-atlassian/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.16.0","@types/form-data":"^2.2.1","axios":"^1.11.0","dompurify":"^3.2.6","dotenv":"^17.2.0","form-data":"^4.0.4","https-proxy-agent":"^7.0.6","winston":"^3.17.0"},"devDependencies":{"@types/dompurify":"^3.0.5","@types/jsdom":"^21.1.7","@types/node":"^24.1.0","@typescript-eslint/eslint-plugin":"^8.39.0","@typescript-eslint/parser":"^8.39.0","@vitest/coverage-v8":"^3.2.4","@vitest/ui":"^3.2.4","eslint":"^9.33.0","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.4","jsdom":"^21.1.2","prettier":"^3.6.2","tsx":"^4.20.3","typescript":"^5.8.3","vitest":"^3.2.4"},"_id":"mcp-atlassian@2.1.0","gitHead":"c1f3904a1dbb88ada43f8adca55442aec4b632b2","types":"./dist/index.d.ts","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-A3gRBeqlGydqSJf3bcPQ5pRvISnAQ5v9GbQ3Fg5P1BSfLH5YbppH+94/3HHwaWbLnceJ5V3t3l/C2KIhSVxq2w==","shasum":"d1461f5ddb8c8842aa868bbf7455a743b5390c24","tarball":"https://registry.npmjs.org/mcp-atlassian/-/mcp-atlassian-2.1.0.tgz","fileCount":72,"unpackedSize":548544,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC+5kgJnWqRGjeKikXHq6J1sBi4/1NDJPGydLL3P8sFiwIhALJ42pHzW5wNscliHfTAebQn0dMwayhL+B3M2Y1YWy7j"}]},"_npmUser":{"name":"vijay_duke","email":"Mail@VijayIyengar.com"},"directories":{},"maintainers":[{"name":"vijay_duke","email":"Mail@VijayIyengar.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-atlassian_2.1.0_1754884630228_0.964084659980408"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-10T13:42:39.261Z","modified":"2025-08-11T03:57:10.693Z","2.0.0":"2025-08-10T13:42:39.542Z","2.0.1":"2025-08-10T14:55:06.340Z","2.0.2":"2025-08-10T22:40:42.209Z","2.1.0":"2025-08-11T03:57:10.501Z"},"bugs":{"url":"https://github.com/Vijay-Duke/mcp-atlassian/issues"},"author":{"name":"MCP Atlassian Contributors"},"license":"MIT","homepage":"https://github.com/Vijay-Duke/mcp-atlassian#readme","keywords":["mcp","atlassian","confluence","jira","model-context-protocol","ai-assistant","claude"],"repository":{"type":"git","url":"git+https://github.com/Vijay-Duke/mcp-atlassian.git"},"description":"MCP server for Atlassian (Confluence and Jira) integration","maintainers":[{"name":"vijay_duke","email":"Mail@VijayIyengar.com"}],"readme":"# MCP Atlassian Server\n\nA Model Context Protocol (MCP) server for integrating with Atlassian products (Confluence and Jira). This server provides tools for AI assistants to interact with Atlassian Cloud APIs, enabling document management, search, and export capabilities.\n\n## Features\n\n### Confluence Integration\n- **Read & Search**: Access pages, spaces, and content\n- **Content Management**: Create, update pages and comments\n- **Page Hierarchy**: Navigate parent/child page relationships\n- **Export**: Export pages as HTML or Markdown with embedded images\n- **Attachments**: List, download, and upload attachments\n- **Labels**: Manage page labels\n- **Users**: Find and query users, track personal activity\n- **Personal Dashboard**: View recent pages and mentions\n\n### Jira Integration  \n- **Issues**: Read and search issues, get personal tasks\n- **Projects**: List and explore projects\n- **Boards & Sprints**: List boards, view sprints, track active work\n- **Comments**: Add comments to issues\n- **Issue Creation**: Create new issues with custom fields\n- **User Management**: Get current user details\n- **Personal Dashboard**: View your open issues and sprint tasks\n\n## Installation\n\n### Option 1: Clone and Build (Recommended)\n\n```bash\n# Clone the repository\ngit clone https://github.com/Vijay-Duke/mcp-atlassian.git\ncd mcp-atlassian\n\n# Install dependencies\nnpm install\n\n# Build TypeScript\nnpm run build\n```\n\n### Option 2: Install from GitHub\n\n```bash\n# Install directly from GitHub\nnpm install -g github:Vijay-Duke/mcp-atlassian\n\n# Or install in your project\nnpm install github:Vijay-Duke/mcp-atlassian\n```\n\n### Option 3: NPM Registry\n\n```bash\n# Install globally\nnpm install -g mcp-atlassian\n\n# Or install locally\nnpm install mcp-atlassian\n```\n\n## Configuration\n\n### Environment Variables\n\nCreate a `.env` file in the root directory:\n\n```env\nATLASSIAN_BASE_URL=https://yourdomain.atlassian.net\nATLASSIAN_EMAIL=your-email@example.com\nATLASSIAN_API_TOKEN=your-api-token\n```\n\n### Getting API Token\n\n1. Log in to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click \"Create API token\"\n3. Give it a label and copy the token\n4. Use this token in your `.env` file\n\n### MCP Settings Configuration\n\nAdd to your Claude Desktop config file:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n#### Option 1: After npm install -g\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-atlassian\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-atlassian\"],\n      \"env\": {\n        \"ATLASSIAN_BASE_URL\": \"https://yourdomain.atlassian.net\",\n        \"ATLASSIAN_EMAIL\": \"your-email@example.com\",\n        \"ATLASSIAN_API_TOKEN\": \"YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n#### Option 2: From Local Clone\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-atlassian\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/your/mcp-atlassian/dist/index.js\"],\n      \"env\": {\n        \"ATLASSIAN_BASE_URL\": \"https://yourdomain.atlassian.net\",\n        \"ATLASSIAN_EMAIL\": \"your-email@example.com\",\n        \"ATLASSIAN_API_TOKEN\": \"YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n**Example with typical paths:**\n```json\n{\n  \"mcpServers\": {\n    \"mcp-atlassian\": {\n      \"command\": \"node\",\n      \"args\": [\"~/projects/mcp-atlassian/dist/index.js\"],\n      \"env\": {\n        \"ATLASSIAN_BASE_URL\": \"https://yourdomain.atlassian.net\",\n        \"ATLASSIAN_EMAIL\": \"your.email@company.com\",\n        \"ATLASSIAN_API_TOKEN\": \"YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n#### Option 3: Direct from GitHub using uvx (Coming Soon)\n\nYou can run the server directly from GitHub without cloning:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-atlassian\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"git+https://github.com/Vijay-Duke/mcp-atlassian.git\", \"mcp-atlassian\"],\n      \"env\": {\n        \"ATLASSIAN_BASE_URL\": \"https://yourdomain.atlassian.net\",\n        \"ATLASSIAN_EMAIL\": \"your-email@example.com\",\n        \"ATLASSIAN_API_TOKEN\": \"YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n**Note:** The uvx method requires the package to be properly configured for Python packaging. This is planned for a future release.\n\n## Available Tools\n\n### Confluence Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_confluence_current_user` | Get details of the authenticated user |\n| `get_confluence_user` | Get details for a specific user |\n| `search_confluence_pages_by_user` | Search pages by user activity |\n| `list_user_confluence_pages` | List pages authored by a user |\n| `list_user_confluence_attachments` | List attachments uploaded by a user |\n| `read_confluence_page` | Read a Confluence page by ID or title |\n| `search_confluence_pages` | Search pages using CQL (Confluence Query Language) |\n| `list_confluence_spaces` | List all accessible spaces |\n| `get_confluence_space` | Get details of a specific space |\n| `create_confluence_page` | Create a new page |\n| `update_confluence_page` | Update existing page content |\n| `list_confluence_page_children` | List child pages of a page |\n| `list_confluence_page_ancestors` | Get parent hierarchy of a page |\n| `export_confluence_page` | Export page as HTML or Markdown with embedded images |\n| `list_confluence_attachments` | List page attachments |\n| `download_confluence_attachment` | Download specific attachment |\n| `upload_confluence_attachment` | Upload file to a page |\n| `download_confluence_page_complete` | Download page with all content |\n| `add_confluence_comment` | Add comment to a page |\n| `list_confluence_page_labels` | Get page labels |\n| `add_confluence_page_label` | Add labels to a page |\n| `find_confluence_users` | Search for users |\n| `get_my_recent_confluence_pages` | List your recent pages |\n| `get_confluence_pages_mentioning_me` | Find pages that mention you |\n\n### Jira Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_jira_current_user` | Get details of the authenticated user |\n| `get_jira_user` | Get details for a specific user |\n| `search_jira_issues_by_user` | Search issues by user involvement |\n| `list_user_jira_issues` | List issues by user role with date filtering |\n| `get_user_jira_activity` | Track user activity including comments and transitions |\n| `get_user_jira_worklog` | Get time tracking entries with formatted totals |\n| `read_jira_issue` | Read issue details by key |\n| `search_jira_issues` | Search issues using JQL |\n| `list_jira_projects` | List all accessible projects |\n| `create_jira_issue` | Create new issue |\n| `add_jira_comment` | Add comment to issue |\n| `list_jira_boards` | List accessible Scrum/Kanban boards |\n| `list_jira_sprints` | List sprints for a board |\n| `get_jira_sprint` | Get detailed sprint information |\n| `get_my_tasks_in_current_sprint` | Get your tasks in active sprints |\n| `get_my_open_issues` | Get all your open issues |\n\n## Usage Examples\n\n### Export Confluence Page\n\n```javascript\n// Export as HTML (raw content with embedded images)\n{\n  \"tool\": \"export_confluence_page\",\n  \"arguments\": {\n    \"pageId\": \"123456789\",\n    \"format\": \"html\"\n  }\n}\n\n// Export as Markdown with metadata\n{\n  \"tool\": \"export_confluence_page\",\n  \"arguments\": {\n    \"pageId\": \"123456789\",\n    \"format\": \"markdown\"\n  }\n}\n```\n\n### Search Confluence\n\n```javascript\n{\n  \"tool\": \"search_confluence_pages\",\n  \"arguments\": {\n    \"cql\": \"space=DEV AND text~'architecture'\",\n    \"limit\": 10\n  }\n}\n```\n\n### Create Jira Issue\n\n```javascript\n{\n  \"tool\": \"create_jira_issue\",\n  \"arguments\": {\n    \"projectKey\": \"PROJ\",\n    \"issueType\": \"Task\",\n    \"summary\": \"Implement new feature\",\n    \"description\": \"Detailed description here\",\n    \"priority\": \"Medium\"\n  }\n}\n```\n\n### Get Your Sprint Tasks\n\n```javascript\n// Get your tasks in the current sprint\n{\n  \"tool\": \"get_my_tasks_in_current_sprint\",\n  \"arguments\": {\n    \"projectKey\": \"PROJ\"\n  }\n}\n\n// Get all your open issues\n{\n  \"tool\": \"get_my_open_issues\",\n  \"arguments\": {\n    \"projectKeys\": [\"PROJ1\", \"PROJ2\"],\n    \"maxResults\": 50\n  }\n}\n```\n\n### Work with Boards and Sprints\n\n```javascript\n// List boards for a project\n{\n  \"tool\": \"list_jira_boards\",\n  \"arguments\": {\n    \"projectKeyOrId\": \"PROJ\",\n    \"type\": \"scrum\"\n  }\n}\n\n// Get active sprints for a board\n{\n  \"tool\": \"list_jira_sprints\",\n  \"arguments\": {\n    \"boardId\": 123,\n    \"state\": \"active\"\n  }\n}\n```\n\n### User-Specific Jira Operations\n\n```javascript\n// Get user details\n{\n  \"tool\": \"get_jira_user\",\n  \"arguments\": {\n    \"username\": \"john.doe\"\n  }\n}\n\n// Search issues by user involvement\n{\n  \"tool\": \"search_jira_issues_by_user\",\n  \"arguments\": {\n    \"username\": \"john.doe\",\n    \"searchType\": \"assignee\",\n    \"status\": \"In Progress\",\n    \"maxResults\": 20\n  }\n}\n\n// Get user's work logs\n{\n  \"tool\": \"get_user_jira_worklog\",\n  \"arguments\": {\n    \"username\": \"john.doe\",\n    \"startDate\": \"2024-01-01\",\n    \"endDate\": \"2024-01-31\",\n    \"projectKeys\": [\"PROJ1\", \"PROJ2\"]\n  }\n}\n\n// Track user activity\n{\n  \"tool\": \"get_user_jira_activity\",\n  \"arguments\": {\n    \"username\": \"john.doe\",\n    \"activityType\": \"all\",\n    \"days\": 7\n  }\n}\n```\n\n## Content Format Support\n\n### Markdown ↔ Confluence Storage Format\n\nThe server automatically converts between Markdown and Confluence's storage format:\n- Write content in Markdown when creating/updating pages\n- Read pages in either storage format or converted to Markdown\n- Preserves formatting, links, and structure\n\n### Export Formats\n\n- **HTML**: Raw Confluence HTML with all images embedded as base64 data URIs\n- **Markdown**: Clean Markdown with YAML frontmatter, includes metadata and embedded images\n\n## Development\n\n```bash\n# Run TypeScript compiler in watch mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Run tests (if available)\nnpm test\n```\n\n## Project Structure\n\n```\nmcp-atlassian/\n├── src/\n│   ├── index.ts                 # Main server entry point\n│   ├── types/                   # TypeScript type definitions\n│   ├── confluence/\n│   │   ├── handlers.ts          # Confluence API handlers\n│   │   └── tools.ts             # Tool definitions\n│   ├── jira/\n│   │   ├── handlers.ts          # Jira API handlers\n│   │   └── tools.ts             # Tool definitions\n│   └── utils/\n│       ├── http-client.ts       # Axios HTTP client setup\n│       ├── content-converter.ts # Markdown ↔ Storage conversion\n│       └── export-converter.ts  # HTML/Markdown export utilities\n├── dist/                        # Compiled JavaScript\n├── .env                         # Environment variables (not in git)\n├── package.json\n└── tsconfig.json\n```\n\n## Security Notes\n\n- API tokens are stored in environment variables, never in code\n- Uses Basic Authentication with API tokens (not passwords)\n- All requests are made over HTTPS\n- Supports Atlassian Cloud only (not Server/Data Center)\n\n## Limitations\n\n- No delete operations implemented (by design for safety)\n- Export to PDF requires browser conversion (HTML → Print → PDF)\n- Some Confluence macros may not convert perfectly to Markdown\n- Rate limits apply based on Atlassian Cloud API limits\n\n## CI/CD Pipeline\n\nThis project uses GitHub Actions for continuous integration and deployment.\n\n### Workflows\n\n#### 🔄 Continuous Integration (`ci.yml`)\n- **Triggers**: Push to main/develop, Pull requests\n- **Jobs**:\n  - **Test**: Runs tests on Node.js 18.x, 20.x, and 22.x\n  - **Build**: Compiles TypeScript and validates the build\n  - **Lint**: Type checking and security audit\n  - **Validate Package**: Ensures package size and structure\n\n#### 📦 Publish to npm (`publish.yml`)\n- **Triggers**: GitHub releases, Manual dispatch\n- **Features**:\n  - Automatic version bumping\n  - npm publishing with provenance\n  - GitHub release creation\n  - Changelog updates\n\n#### 🔒 Security Scanning (`security.yml`)\n- **Triggers**: Push to main, PRs, Weekly schedule\n- **Scans**:\n  - npm audit for vulnerabilities\n  - CodeQL analysis\n  - OWASP dependency check\n  - Snyk security scanning (optional)\n\n#### 🏷️ Release Management (`release.yml`)\n- **Triggers**: Version tags, Manual dispatch\n- **Features**:\n  - Automatic changelog generation\n  - GitHub release creation\n  - Build artifacts attachment\n  - Release notes formatting\n\n#### ✅ PR Validation (`pr-validation.yml`)\n- **Triggers**: Pull request events\n- **Checks**:\n  - Semantic PR title validation\n  - PR size labeling\n  - Auto-labeling based on files changed\n\n### 🤖 Automated Dependency Updates\n\nDependabot is configured to:\n- Check for npm dependency updates weekly\n- Check for GitHub Actions updates weekly\n- Group non-major updates together\n- Create PRs with proper labels\n\n### Setting Up CI/CD\n\n#### Required GitHub Secrets\n\n1. **NPM_TOKEN**: npm authentication token for publishing\n   - Generate at: https://www.npmjs.com/settings/YOUR_USERNAME/tokens\n   - Required scopes: `publish`\n\n2. **SNYK_TOKEN** (Optional): For Snyk security scanning\n   - Get from: https://app.snyk.io/account\n\n#### Branch Protection\n\nRecommended branch protection rules for `main`:\n- Require PR reviews before merging\n- Require status checks to pass (CI tests)\n- Require branches to be up to date\n- Include administrators in restrictions\n\n### Local Development\n\nBefore pushing changes:\n\n```bash\n# Run tests locally\nnpm test\n\n# Build the project\nnpm run build\n\n# Check for security vulnerabilities\nnpm audit\n\n# Type check\nnpx tsc --noEmit\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Support\n\nFor issues and questions:\n- Create an issue in the GitHub repository\n- Check Atlassian API documentation for API-specific questions\n- Review MCP documentation for protocol-related topics\n\n## Acknowledgments\n\nBuilt with:\n- [Model Context Protocol (MCP)](https://modelcontextprotocol.io)\n- [Atlassian REST APIs](https://developer.atlassian.com/cloud/)\n- TypeScript, Node.js, Axios","readmeFilename":"README.md"}