mcp atlassian

Local 2025-08-31 23:50:10 0
search @petrsovadina/mcp-atlassian

Integrates Atlassian products (Confluence, Jira) with Model Context Protocol, enabling easy access to Confluence content and Jira tickets through the MCP interface.

MCP server pro integraci Atlassian produktů (Confluence, Jira) s Model Context Protocol. Tento nástroj umožňuje snadný přístup k vašemu Confluence obsahu a Jira ticketům přímo přes MCP rozhraní.

Funkce

Confluence

  • Vyhledávání obsahu pomocí CQL (Confluence Query Language)
  • Přístup ke stránkám, přílohám a komentářům
  • Filtrování podle prostoru (space)

Jira

  • Vyhledávání issues pomocí JQL (Jira Query Language)
  • Získávání detailů o issues včetně statusu, přiřazení a časových značek

Instalace

git clone https://github.com/petrsovadina/mcp-atlassian.git
cd mcp-atlassian
npm install
npm run build

Konfigurace

Nastavte následující proměnné prostředí:

Confluence

CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
[email protected]
CONFLUENCE_API_TOKEN=your-api-token

Jira

JIRA_URL=https://your-domain.atlassian.net
[email protected]
JIRA_API_TOKEN=your-api-token

Použití v MCP

Přidejte následující konfiguraci do vašeho MCP settings souboru:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/path/to/mcp-atlassian/build/index.js"],
      "env": {
        "CONFLUENCE_URL": "your-confluence-url",
        "CONFLUENCE_USERNAME": "your-username",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "JIRA_URL": "your-jira-url",
        "JIRA_USERNAME": "your-username",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Dostupné nástroje

Vyhledávání v Confluence obsahu pomocí CQL.

{
  "query": "type=page AND space='Engineering'", // CQL dotaz
  "limit": 10 // volitelný limit výsledků (1-50)
}

Vyhledávání Jira issues pomocí JQL.

{
  "jql": "project = ENG AND status = Open", // JQL dotaz
  "fields": "summary,status,assignee", // volitelné pole
  "limit": 10 // volitelný limit výsledků (1-50)
}

Resource Templates

Confluence Page

confluence://{space_key}/pages/{title}

Jira Issue

jira://{project_key}/issues/{issue_key}

Příklady použití

Vyhledávání v Confluence

const result = await mcp.use('confluence_search', {
  query: "type=page AND space='Engineering' ORDER BY created DESC",
  limit: 5
});

Vyhledávání v Jira

const result = await mcp.use('jira_search', {
  jql: "project = ENG AND status = 'In Progress'",
  fields: "summary,status,assignee,created",
  limit: 5
});

Přispívání

Pokud chcete přispět k vývoji, můžete: 1. Forkovat repozitář 2. Vytvořit feature branch 3. Commitnout vaše změny 4. Pushnout branch 5. Vytvořit Pull Request

Licence

MIT

[
  {
    "description": "Search Confluence content using CQL",
    "inputSchema": {
      "properties": {
        "limit": {
          "description": "Results limit (1-50)",
          "maximum": 50,
          "minimum": 1,
          "type": "number"
        },
        "query": {
          "description": "CQL query string",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "confluence_search"
  },
  {
    "description": "Search Jira issues using JQL",
    "inputSchema": {
      "properties": {
        "fields": {
          "description": "Comma-separated fields",
          "type": "string"
        },
        "jql": {
          "description": "JQL query string",
          "type": "string"
        },
        "limit": {
          "description": "Results limit (1-50)",
          "maximum": 50,
          "minimum": 1,
          "type": "number"
        }
      },
      "required": [
        "jql"
      ],
      "type": "object"
    },
    "name": "jira_search"
  }
]