Jira & Confluence MCP Servers

Jira & Confluence MCP Servers

Servidores MCP (Model Context Protocol) basados en Python que permiten interactuar con las APIs de Jira y Confluence.

Configuración

1. Instalación de dependencias

uv sync

2. Configuración de variables de entorno

Copie .env.example a .env y configure las credenciales:

cp .env.example .env

Configure la siguiente información:

• JIRA_URL / CONFLUENCE_URL: URL de la instancia de Atlassian
• JIRA_USERNAME / CONFLUENCE_USERNAME: Dirección de correo electrónico
• JIRA_API_TOKEN / CONFLUENCE_API_TOKEN: Token de API (generado aquí)
• JIRA_CLOUD / CONFLUENCE_CLOUD: true para la versión en la nube, false para la versión de servidor

Uso

Iniciar el servidor MCP de Jira

uv run python src/jira_server.py

Iniciar el servidor MCP de Confluence

uv run python src/confluence_server.py

Herramientas disponibles

Jira MCP

• jira_search_issues: Buscar problemas usando JQL
• jira_get_issue: Obtener detalles de un problema específico
• jira_create_issue: Crear un nuevo problema
• jira_update_issue: Actualizar un problema existente
• jira_add_comment: Añadir un comentario a un problema
• jira_transition_issue: Cambiar el estado de un problema
• jira_get_projects: Obtener la lista de proyectos

Confluence MCP

• confluence_search_content: Buscar contenido usando CQL
• confluence_get_page: Obtener detalles de una página
• confluence_create_page: Crear una nueva página
• confluence_update_page: Actualizar una página existente
• confluence_delete_page: Eliminar una página
• confluence_get_spaces: Obtener la lista de espacios
• confluence_get_page_children: Obtener páginas hijas
• confluence_add_attachment: Añadir archivos adjuntos a una página

Configuración en Claude Desktop

Añada lo siguiente al archivo de configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "jira": {
      "command": "/path/to/jira-confluence-mcp/run_jira.sh",
      "args": [],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_CLOUD": "true"
      }
    },
    "confluence": {
      "command": "/path/to/jira-confluence-mcp/run_confluence.sh",
      "args": [],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USERNAME": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_CLOUD": "true"
      }
    }
  }
}

Nota:

• Reemplace la parte /path/to/jira-confluence-mcp/ con la ruta real del proyecto
• El token de API se puede generar desde Configuración de la cuenta de Atlassian
• run_jira.sh y run_confluence.sh son scripts de shell ubicados en la raíz del proyecto

Ejemplos de uso

Jira

# イシューの検索
await jira_search_issues({"jql": "project = PROJ AND status = 'In Progress'", "max_results": 10})

# イシューの作成
await jira_create_issue({
    "project_key": "PROJ",
    "summary": "新しいタスク",
    "description": "タスクの説明",
    "issue_type": "Task",
    "priority": "Medium"
})

# イシューのステータス変更
await jira_transition_issue({"issue_key": "PROJ-123", "status": "Done"})

Confluence

# ページの検索
await confluence_search_content({"cql": "space = DEV AND title ~ 'API'"})

# ページの作成
await confluence_create_page({
    "space_key": "DEV",
    "title": "新しいドキュメント",
    "content": "<p>ページの内容</p>"
})

# ページの更新
await confluence_update_page({
    "page_id": "123456",
    "content": "<p>更新された内容</p>",
    "version_comment": "APIドキュメントを更新"
})

Licencia

MIT