atlassian-onprem-mcp 1.0.1

atlassian-onprem-mcp

خادم MCP لأتلاسيان (Confluence + Jira + Bitbucket)

A comprehensive Model Context Protocol (MCP) server for Atlassian on-premise installations. Provides AI assistants with 60+ tools for full CRUD operations across Confluence, Jira, and Bitbucket Server.

خادم بروتوكول سياق النموذج (MCP) شامل لتثبيتات أتلاسيان المحلية. يوفر لمساعدي الذكاء الاصطناعي أكثر من 60 أداة لعمليات كاملة عبر Confluence و Jira و Bitbucket Server.

✨ Features | المميزات

• Confluence - 21 tools: Search, CRUD pages, comments, labels, spaces, attachments, history
• Jira - 22 tools: Search (JQL), CRUD issues, transitions, comments, worklogs, watchers, links
• Bitbucket - 20 tools: Projects, repos, branches, commits, PRs (create/merge/approve/decline), file browsing
• Authentication - PAT (Bearer) and Basic (username:password) support
• On-Premise - Designed for Atlassian Server/Data Center installations
• Bilingual - English + Arabic descriptions for all tools

📦 Installation | التثبيت

As a .NET Global Tool (Recommended)

dotnet tool install -g atlassian-onprem-mcp

From Source

git clone https://github.com/atlassian-onprem-mcp/atlassian-onprem-mcp.git
cd atlassian-onprem-mcp/ConfluenceMcpServer
dotnet build

⚙️ Configuration | الإعدادات

Environment Variables | متغيرات البيئة

* When using AUTH_TYPE=basic, tokens are not required — username/password is used instead.

Command Line Arguments | وسائط سطر الأوامر

atlassian-onprem-mcp \
  --confluence-base-url=https://wiki.example.com \
  --confluence-token=your-token \
  --jira-base-url=https://jira.example.com \
  --jira-token=your-token \
  --bitbucket-base-url=https://bitbucket.example.com \
  --bitbucket-token=your-token \
  --auth-type=pat \
  --default-space-key=MYSPACE

🔧 MCP Configuration | إعدادات MCP

VS Code / GitHub Copilot

Create .vscode/mcp.json in your workspace:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-onprem-mcp",
      "args": [],
      "env": {
        "CONFLUENCE_BASE_URL": "https://wiki.example.com",
        "CONFLUENCE_TOKEN": "your-confluence-pat",
        "JIRA_BASE_URL": "https://jira.example.com",
        "JIRA_TOKEN": "your-jira-pat",
        "BITBUCKET_BASE_URL": "https://bitbucket.example.com",
        "BITBUCKET_TOKEN": "your-bitbucket-pat",
        "DEFAULT_SPACE_KEY": "MYSPACE"
      }
    }
  }
}

Basic Authentication

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-onprem-mcp",
      "args": [],
      "env": {
        "CONFLUENCE_BASE_URL": "https://wiki.example.com",
        "JIRA_BASE_URL": "https://jira.example.com",
        "BITBUCKET_BASE_URL": "https://bitbucket.example.com",
        "AUTH_TYPE": "basic",
        "ATLASSIAN_USERNAME": "your-username",
        "ATLASSIAN_PASSWORD": "your-password"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-onprem-mcp",
      "env": {
        "CONFLUENCE_BASE_URL": "https://wiki.example.com",
        "CONFLUENCE_TOKEN": "your-pat",
        "JIRA_BASE_URL": "https://jira.example.com",
        "JIRA_TOKEN": "your-pat",
        "BITBUCKET_BASE_URL": "https://bitbucket.example.com",
        "BITBUCKET_TOKEN": "your-pat"
      }
    }
  }
}

🛠️ Available Tools (63 Total) | الأدوات المتاحة

Confluence (21 tools) | أدوات Confluence

Read Operations | عمليات القراءة

Write Operations | عمليات الكتابة

Jira (22 tools) | أدوات Jira

Read Operations | عمليات القراءة

Write Operations | عمليات الكتابة

Bitbucket Server (20 tools) | أدوات Bitbucket

Read Operations | عمليات القراءة

Write Operations | عمليات الكتابة

🔐 Authentication | المصادقة

PAT (Personal Access Token) - Default | الافتراضي

Generate a PAT from your Atlassian product settings:

• Confluence: Profile → Personal Access Tokens
• Jira: Profile → Personal Access Tokens
• Bitbucket: HTTP Access Tokens in repository/project settings

Basic Authentication | المصادقة الأساسية

Set AUTH_TYPE=basic and provide ATLASSIAN_USERNAME and ATLASSIAN_PASSWORD. The same credentials are used for all three products.

🏗️ Architecture | البنية

ConfluenceMcpServer/
├── Configuration/
│   └── McpServerConfiguration.cs    # Configuration management
├── Http/
│   └── HttpClientFactory.cs         # HTTP client creation with auth
├── Models/
│   ├── JsonRpcModels.cs             # JSON-RPC protocol models
│   └── McpToolDefinition.cs         # Tool definition models
├── Server/
│   └── McpServer.cs                 # MCP protocol handler (stdio)
├── Services/
│   └── ConfluenceEnrichmentService.cs  # Page enrichment logic
├── Tools/
│   ├── IToolHandler.cs              # Base interface & BaseToolHandler
│   ├── ConfluenceToolHandler.cs     # 21 Confluence tools
│   ├── JiraToolHandler.cs           # 22 Jira tools
│   └── BitbucketToolHandler.cs      # 20 Bitbucket tools
└── Program.cs                       # Entry point

🔌 Extensibility | قابلية التوسع

Add custom tools by implementing BaseToolHandler:

public class MyToolHandler : BaseToolHandler
{
    public MyToolHandler(HttpClient httpClient) : base(httpClient) { }

    public override bool CanHandle(string toolName) => toolName == "my_tool";

    public override IEnumerable<McpToolDefinition> GetTools()
    {
        yield return McpToolDefinition.Create(
            name: "my_tool",
            englishDescription: "My custom tool",
            arabicDescription: "أداتي المخصصة",
            inputSchema: new McpInputSchema { ... });
    }

    public override async Task<ToolResult> ExecuteAsync(string toolName, JsonNode? arguments)
    {
        var result = await GetJsonAsync("/my/endpoint");
        return ToolResult.Success(result);
    }
}

📋 Requirements | المتطلبات

• .NET 8.0 SDK or later
• Atlassian Server/Data Center (on-premise) installation
• Valid authentication credentials (PAT or Basic)

📄 License | الرخصة

MIT

�‍💻 Author | المؤلف

Mohammed Khalil

Built for the Atlassian on-premise community.

تم بناءه لمجتمع أتلاسيان المحلي.