feat(atlassian): add Jira and Confluence integration

[cloudbridgeuy]

Summary

This pull request adds comprehensive Atlassian integration to mcptools, enabling seamless interaction with Jira and Confluence through both CLI and MCP interfaces.

Features Added

Jira Integration:

• Search and list Jira issues using JQL (Jira Query Language)
• View issue details: key, summary, description, status, and assignee
• Configurable result limits
• JSON and human-readable table output

Confluence Integration:

• Search Confluence pages using CQL (Confluence Query Language)
• View page details: title, type, URL, and converted plain-text content
• Automatic HTML-to-plain-text conversion
• JSON and human-readable table output

Authentication:

• API Token-based authentication (Basic Auth)
• Environment variable configuration (ATLASSIAN_BASE_URL, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN)
• Support for CLI argument overrides

MCP Tools:

• jira_list - Search Jira issues programmatically
• confluence_search - Search Confluence pages programmatically
• Properly formatted JSON responses for LLM consumption

Implementation Details

New Files:

• crates/mcptools/src/atlassian/mod.rs - Core module with authentication
• crates/mcptools/src/atlassian/jira.rs - Jira operations
• crates/mcptools/src/atlassian/confluence.rs - Confluence operations
• crates/mcptools/src/mcp/tools/atlassian.rs - MCP tool handlers
• ATLASSIAN_SETUP.md - Comprehensive setup and configuration guide
• ATLASSIAN_QUICK_START.md - Quick reference guide with examples

Modified Files:

• crates/mcptools/src/main.rs - Added Atlassian module integration
• crates/mcptools/src/mcp/tools/mod.rs - Registered MCP tools
• CLAUDE.md - Updated project documentation
• Cargo.toml - Added dependencies (base64, html-escape)

Dependencies Added:

• base64 v0.21.7 - For Basic Authentication encoding
• html-escape v0.2.13 - For HTML entity decoding

Commits

This PR includes 6 semantic commits:

1. feat(atlassian): Core Jira and Confluence module with API integration
2. feat(mcp): MCP tool handlers for Jira and Confluence
3. feat(cli): Integration into main application and environment setup
4. build: Dependencies for base64 and html-escape
5. docs(atlassian): Comprehensive setup and quick start guides
6. docs(claude): Update project documentation

Usage Examples

Search Jira Issues:

mcptools atlassian jira list "project = PROJ AND status = Open"
mcptools atlassian jira list "assignee = currentUser()" --limit 20
mcptools atlassian jira list "text ~ 'database'" --json

Search Confluence Pages:

mcptools atlassian confluence search "text ~ 'deployment'"
mcptools atlassian confluence search "space = WIKI" --limit 10
mcptools atlassian confluence search "text ~ 'api'" --json

Test Plan

• Build succeeds with no errors or warnings
• CLI help commands display correctly
• Jira list command accepts JQL queries
• Confluence search command accepts CQL queries
• Environment variable configuration is recognized
• JSON output formatting works as expected
• MCP tool registration and routing works
• Pre-commit hooks pass (rustfmt, cargo check, clippy)

Documentation

• Detailed setup guide: ATLASSIAN_SETUP.md
• Quick reference: ATLASSIAN_QUICK_START.md
• Project documentation: Updated CLAUDE.md

Security Considerations

• API tokens are loaded from environment variables (not hardcoded)
• Basic Auth credentials are properly formatted
• Follows security best practices for credential handling
• Documentation includes security recommendations

---

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com