更好的 Confluence 通信服务器

概述

此服务器实现了用于 Confluence 集成的模型上下文协议 (MCP)。**此版本解决并修复了现有 Confluence 服务器中发现的错误，从而提供更稳定可靠的体验。**它提供了执行 CQL 查询和从 Confluence 检索页面内容的功能。

该服务器遵循 MCP 客户端-服务器架构：

• 充当提供 Confluence 功能的 MCP 服务器

• 连接到 Confluence 作为数据源

• 通过标准化协议与 MCP 客户端通信

如何使用

Related MCP server: mcp-jira

与 Claude App、Cline、Roo Code 一起使用

当使用 Claude App 时，您需要直接设置您的 API 密钥和 URL。

{
  "mcpServers": {
    "Confluence communication server": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://XXXXXXXX.atlassian.net",
        "JIRA_URL": "https://XXXXXXXX.atlassian.net",
        "CONFLUENCE_API_MAIL": "Your email",
        "CONFLUENCE_API_KEY": "KEY_FROM: https://id.atlassian.com/manage-profile/security/api-tokens",
        "CONFLUENCE_IS_CLOUD": "true" // Set to "false" for Server/Data Center
      }
    }
  }
}

与游标一起使用

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Confluence 通信服务器：

npx -y @smithery/cli install @zereight/confluence-mcp --client claude

与 Cursor 一起使用时，可以按如下方式设置环境变量并运行服务器：

env CONFLUENCE_API_MAIL=your@email.com CONFLUENCE_API_KEY=your-key CONFLUENCE_URL=your-confluence-url JIRA_URL=your-jira-url npx -y @zereight/mcp-confluence

• CONFLUENCE_API_MAIL ：您的 Confluence API 电子邮件地址。

• CONFLUENCE_API_KEY ：您的 Confluence API 密钥。

• CONFLUENCE_URL ：您的 Confluence URL。

• JIRA_URL ：您的 JIRA URL。

• CONFLUENCE_IS_CLOUD ：确定 Confluence 版本（云或服务器）

  • 默认值：true（云版本）

  • 对于服务器/数据中心版本明确设置为“false”

  • 影响 API 端点路径：

    • 云： /wiki/rest/api

    • 服务器： /rest/api

Confluence 工具

• execute_cql_search ：在 Confluence 上执行 CQL 查询以搜索页面。

  • 描述：在 Confluence 实例上执行 CQL 查询以搜索页面。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "cql": {
          "type": "string",
          "description": "CQL query string"
        },
        "limit": {
          "type": "integer",
          "description": "Number of results to return",
          "default": 10
        }
      },
      "required": ["cql"]
    }

• get_page_content ：检索特定 Confluence 页面的内容。

  • 描述：使用页面 ID 获取 Confluence 页面的内容。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "pageId": {
          "type": "string",
          "description": "Confluence Page ID"
        }
      },
      "required": ["pageId"]
    }

• create_page ：创建一个新的 Confluence 页面。

  • 描述：在指定的 Confluence 空间中创建一个新页面。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "spaceKey": {
          "type": "string",
          "description": "Space key where the page will be created"
        },
        "title": {
          "type": "string",
          "description": "Page title"
        },
        "content": {
          "type": "string",
          "description": "Page content in storage format"
        },
        "parentId": {
          "type": "string",
          "description": "Parent page ID (optional)"
        }
      },
      "required": ["spaceKey", "title", "content"]
    }

• update_page ：更新现有的 Confluence 页面。

  • 描述：更新现有 Confluence 页面的内容。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "pageId": {
          "type": "string",
          "description": "ID of the page to update"
        },
        "content": {
          "type": "string",
          "description": "New page content in storage format"
        },
        "title": {
          "type": "string",
          "description": "New page title (optional)"
        }
      },
      "required": ["pageId", "content"]
    }

Jira 工具

• execute_jql_search ：在 Jira 上执行 JQL 查询以搜索问题。

  • 描述：在 Jira 实例上执行 JQL 查询以搜索问题。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "jql": {
          "type": "string",
          "description": "JQL query string"
        },
        "limit": {
          "type": "integer",
          "description": "Number of results to return",
          "default": 10
        }
      },
      "required": ["jql"]
    }

• create_jira_issue ：创建一个新的 Jira 问题。

  • 描述：在指定的 Jira 项目中创建新问题。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "project": {
          "type": "string",
          "description": "Project key"
        },
        "summary": {
          "type": "string",
          "description": "Issue summary"
        },
        "description": {
          "type": "string",
          "description": "Issue description"
        },
        "issuetype": {
          "type": "string",
          "description": "Issue type name"
        },
        "assignee": {
          "type": "string",
          "description": "Assignee account ID"
        },
        "priority": {
          "type": "string",
          "description": "Priority ID"
        }
      },
      "required": ["project", "summary", "issuetype"]
    }

• update_jira_issue ：更新现有的 Jira 问题。

  • 描述：更新现有 Jira 问题的字段。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "issueKey": {
          "type": "string",
          "description": "Issue key (e.g., PROJ-123)"
        },
        "summary": {
          "type": "string",
          "description": "New issue summary"
        },
        "description": {
          "type": "string",
          "description": "New issue description"
        },
        "assignee": {
          "type": "string",
          "description": "New assignee account ID"
        },
        "priority": {
          "type": "string",
          "description": "New priority ID"
        }
      },
      "required": ["issueKey"]
    }

• transition_jira_issue ：更改 Jira 问题的状态。

  • 描述：使用转换 ID 更改 Jira 问题的状态。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "issueKey": {
          "type": "string",
          "description": "Issue key (e.g. PROJ-123)"
        },
        "transitionId": {
          "type": "string",
          "description": "Transition ID to change the issue status"
        }
      },
      "required": ["issueKey", "transitionId"]
    }

• get_board_sprints ：从 Jira 板获取所有冲刺。

  • 描述：从指定的 Jira 板检索所有冲刺。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "boardId": {
          "type": "string",
          "description": "Jira board ID"
        },
        "state": {
          "type": "string",
          "description": "Filter sprints by state (active, future, closed)",
          "enum": ["active", "future", "closed"]
        }
      },
      "required": ["boardId"]
    }

• get_sprint_issues ：获取冲刺中的所有问题。

  • 描述：检索指定冲刺中的所有问题。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "sprintId": {
          "type": "string",
          "description": "Sprint ID"
        },
        "fields": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of fields to return for each issue"
        }
      },
      "required": ["sprintId"]
    }

• get_current_sprint ：从带有问题的板上获取当前活跃的冲刺。

  • 描述：从指定的板上检索当前活动的冲刺及其问题。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "boardId": {
          "type": "string",
          "description": "Jira board ID"
        },
        "includeIssues": {
          "type": "boolean",
          "description": "Whether to include sprint issues in the response",
          "default": true
        }
      },
      "required": ["boardId"]
    }

• get_epic_issues ：获取属于史诗的所有问题。

  • 描述：检索属于指定史诗的所有问题。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "epicKey": {
          "type": "string",
          "description": "Epic issue key (e.g. CONNECT-1234)"
        },
        "fields": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of fields to return for each issue"
        }
      },
      "required": ["epicKey"]
    }

• get_user_issues ：获取分配给或由特定用户在论坛中报告的所有问题。

  • 描述：检索与论坛中特定用户相关的所有问题。

  • 输入模式：

    {
      "type": "object",
      "properties": {
        "boardId": {
          "type": "string",
          "description": "Jira board ID"
        },
        "username": {
          "type": "string",
          "description": "Username to search issues for"
        },
        "type": {
          "type": "string",
          "description": "Type of user association with issues",
          "enum": ["assignee", "reporter"],
          "default": "assignee"
        },
        "status": {
          "type": "string",
          "description": "Filter by issue status",
          "enum": ["open", "in_progress", "done", "all"],
          "default": "all"
        }
      },
      "required": ["boardId", "username"]
    }