此服务器实现了用于 Confluence 集成的模型上下文协议(MCP)。 本版本解决了现有 Confluence 服务器中发现的错误,提供了更加稳定和可靠的经验。 它提供了执行 CQL 查询并从 Confluence 获取页面内容的功能。
该服务器遵循 MCP 客户端-服务器架构:
<a href="https://glama.ai/mcp/servers/p7fnmpaukj"><img width="380" height="200" src="https://gips0.baidu.com/it/u=1704039800,1701141794&fm=3081&app=3081&f=PNG?w=760&h=400" alt="confluence-mcp MCP 服务器" /></a>
当与 Claude 应用一起使用时,需要直接设置您的 API 密钥和 URL。
{
"mcpServers": {
"Confluence 通信服务器": {
"命令": "npx",
"参数": ["-y", "@zereight/mcp-confluence"],
"环境变量": {
"CONFLUENCE_URL": "https://XXXXXXXX.atlassian.net",
"JIRA_URL": "https://XXXXXXXX.atlassian.net",
"CONFLUENCE_API_MAIL": "您的邮箱",
"CONFLUENCE_API_KEY": "来自:https://id.atlassian.com/manage-profile/security/api-tokens 的密钥",
"CONFLUENCE_IS_CLOUD": "true" // 对于 Server/Data Center 设置为 "false"
}
}
}
}
要通过 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 版本(云或服务器)
/wiki/rest/api/rest/apiexecute_cql_search:在 Confluence 上执行 CQL 查询以搜索页面。
{
"type": "object",
"properties": {
"cql": {
"type": "string",
"description": "CQL 查询字符串"
},
"limit": {
"type": "integer",
"description": "返回的结果数量",
"default": 10
}
},
"required": ["cql"]
}
get_page_content:检索特定 Confluence 页面的内容。
{
"type": "object",
"properties": {
"pageId": {
"type": "string",
"description": "Confluence 页面 ID"
}
},
"required": ["pageId"]
}
create_page:创建新的 Confluence 页面。
{
"type": "object",
"properties": {
"spaceKey": {
"type": "string",
"description": "页面将被创建的空间键"
},
"title": {
"type": "string",
"description": "页面标题"
},
"content": {
"type": "string",
"description": "存储格式的页面内容"
},
"parentId": {
"type": "string",
"description": "父页面 ID(可选)"
}
},
"required": ["spaceKey", "title", "content"]
}
update_page:更新现有的 Confluence 页面。
{
"type": "object",
"properties": {
"pageId": {
"type": "string",
"description": "要更新的页面 ID"
},
"content": {
"type": "string",
"description": "存储格式的新页面内容"
},
"title": {
"type": "string",
"description": "新页面标题(可选)"
}
},
"required": ["pageId", "content"]
}
execute_jql_search:在 Jira 上执行 JQL 查询以搜索问题。
{
"type": "object",
"properties": {
"jql": {
"type": "string",
"description": "JQL 查询字符串"
},
"limit": {
"type": "integer",
"description": "返回的结果数量",
"default": 10
}
},
"required": ["jql"]
}
create_jira_issue:创建新的 Jira 问题。
{
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "项目键"
},
"summary": {
"type": "string",
"description": "问题摘要"
},
"description": {
"type": "string",
"description": "问题描述"
},
"issuetype": {
"type": "string",
"description": "问题类型名称"
},
"assignee": {
"type": "string",
"description": "分配人账户 ID"
},
"priority": {
"type": "string",
"description": "优先级 ID"
}
},
"required": ["project", "summary", "issuetype"]
}
update_jira_issue:更新现有的 Jira 问题。
{
"type": "object",
"properties": {
"issueKey": {
"type": "string",
"description": "问题键(例如,PROJ-123)"
},
"summary": {
"type": "string",
"description": "新问题摘要"
},
"description": {
"type": "string",
"description": "新问题描述"
},
"assignee": {
"type": "string",
"description": "新分配人账户 ID"
},
"priority": {
"type": "string",
"description": "新优先级 ID"
}
},
"required": ["issueKey"]
}
transition_jira_issue:更改 Jira 问题的状态。
{
"type": "object",
"properties": {
"issueKey": {
"type": "string",
"description": "问题键(例如,PROJ-123)"
},
"transitionId": {
"type": "string",
"description": "用于更改问题状态的过渡 ID"
}
},
"required": ["issueKey", "transitionId"]
}
get_board_sprints:获取 Jira 看板中的所有冲刺。
{
"type": "object",
"properties": {
"boardId": {
"type": "string",
"description": "Jira 看板 ID"
},
"state": {
"type": "string",
"description": "按状态筛选冲刺(活动、未来、关闭)",
"enum": ["active", "future", "closed"]
}
},
"required": ["boardId"]
}
get_sprint_issues:获取冲刺中的所有问题。
{
"type": "object",
"properties": {
"sprintId": {
"type": "string",
"description": "冲刺 ID"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "每个问题要返回的字段列表"
}
},
"required": ["sprintId"]
}
get_current_sprint:从看板中获取当前活跃的冲刺及其问题。
{
"type": "object",
"properties": {
"boardId": {
"type": "string",
"description": "Jira 看板 ID"
},
"includeIssues": {
"type": "boolean",
"description": "是否在响应中包含冲刺问题",
"default": true
}
},
"required": ["boardId"]
}
get_epic_issues:获取属于某个史诗的所有问题。
{
"type": "object",
"properties": {
"epicKey": {
"type": "string",
"description": "史诗问题键(例如,CONNECT-1234)"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "每个问题要返回的字段列表"
}
},
"required": ["epicKey"]
}
get_user_issues:获取分配给或由特定用户报告的看板中的所有问题。
{
"type": "object",
"properties": {
"boardId": {
"type": "string",
"description": "Jira 看板 ID"
},
"username": {
"type": "string",
"description": "要搜索问题的用户名"
},
"type": {
"type": "string",
"description": "用户与问题的关联类型",
"enum": ["assignee", "reporter"],
"default": "assignee"
},
"status": {
"type": "string",
"description": "按问题状态筛选",
"enum": ["open", "in_progress", "done", "all"],
"default": "all"
}
},
"required": ["boardId", "username"]
}