mcpField
M
MCP Atlassian Server

MCP Atlassian Server

Local
github.com/petrsovadinaVersion Control3Updated 57w ago

About MCP Atlassian Server

MCP Atlassian Server exposes Confluence content and Jira issues through MCP for teams that need to search project documentation and tickets. It supports CQL and JQL queries, along with page and issue resources.

Key features

  1. 01Search Confluence with CQL
  2. 02Access pages, attachments, and comments
  3. 03Filter content by space
  4. 04Search Jira issues with JQL
  5. 05Retrieve issue status and assignee

Use cases

  1. 01Find engineering documentation in a space
  2. 02Filter Jira issues by status
  3. 03Read pages with their comments and attachments

MCP support

It provides MCP clients with Confluence and Jira search tools, plus page and issue resource templates.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"atlassian-petrsovadina": {
"command": "npx",
"args": [
"-y",
"@smithery/cli"
]
}
}
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Atlassian Server

smithery badge

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

Installing via Smithery

To install Atlassian Integration Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @petrsovadina/mcp-atlassian --client claude
Manual Installation
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

confluence_search

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

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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.