Confluence MCP Server

基于 Model Context Protocol (MCP) 的 Confluence 文档访问服务，提供文档搜索和内容获取功能。

功能特性

文档搜索
- 支持标题和全文搜索
- 限制返回结果数量
- 返回匹配内容片段和文档基本信息
文档内容获取
- 获取完整的页面内容
- 包含元数据（标题、空间信息、版本等）
- 创建和修改信息
- 页面标签

快速开始

环境配置

创建 .env 文件配置 Confluence 访问信息：

CONFLUENCE_URL="your-confluence-url"
CONFLUENCE_USERNAME="your-username"
CONFLUENCE_PASSWORD="your-password"
# 或者使用 Token 认证
CONFLUENCE_TOKEN="your-api-token"

安装依赖

# 安装项目依赖
uv pip install -e .

# 或者直接安装依赖包
uv pip install "mcp[cli]>=1.5.0" "atlassian-python-api>=3.41.4" "typer>=0.9.0"

运行服务

# 使用 uvx
/Users/hose/.local/bin/uvx --directory /Users/hose/code/ops/ops-mcp mcp main.py

# 或者使用 uv run
uv run --with mcp mcp run main.py

MCP 接口说明

Tools (工具)

search_confluence
# 搜索 Confluence 内容 Input: - query: str # 搜索关键词 - limit: int = 10 # 返回结果数量限制 Output: { "success": true, "query": "搜索词", "total": 5, "results": [ { "id": "12345", "title": "页面标题", "type": "page", "url": "页面URL", "excerpt": "匹配内容片段" } ] }
get_confluence_page
# 获取页面详细信息 Input: - page_id: str # 页面ID Output: { "success": true, "page": { "id": "12345", "title": "页面标题", "space": { "key": "SPACE", "name": "空间名称" }, "version": 1, "content": "页面内容", "url": "页面URL", "created": { "date": "创建时间", "by": "创建者" }, "modified": { "date": "修改时间", "by": "修改者" }, "labels": ["标签1", "标签2"] } }

Resources (资源)

confluence://pages/{page_id}
- 通过页面ID直接获取页面内容和元数据
- 返回 JSON 格式数据
confluence://search/{query}
- 通过关键词直接搜索内容
- 返回 JSON 格式的搜索结果

错误处理

所有接口在出错时返回统一格式：

{
  "success": false,
  "error": "错误信息描述"
}

使用示例

搜索文档

result = await mcp.use_tool("search_confluence", {
    "query": "Python",
    "limit": 5
})

获取页面内容

page = await mcp.use_tool("get_confluence_page", {
    "page_id": "12345"
})

使用资源URI

content = await mcp.access_resource("confluence://pages/12345")
search_results = await mcp.access_resource("confluence://search/Python")

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that enables searching and retrieving content from Confluence documentation systems, providing capabilities for both document searches and full page content retrieval.

Related MCP Servers

MCP-Ragdocs
qpd-v
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables semantic search and retrieval of documentation using a vector database (Qdrant). This server allows you to add documentation from URLs or local files and then search through them using natural language queries.
Last updated -
14
74
JavaScript
Apache 2.0
Claude AI Documentation Assistant
XPE-7
-
security
F
license
-
quality
An MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.
Last updated -
Python
McpDocServer
ruan11223344
A
security
A
license
A
quality
A documentation server based on MCP protocol designed for various development frameworks that provides multi-threaded document crawling, local document loading, keyword searching, and document detail retrieval.
Last updated -
2
37
JavaScript
MIT License
docs-mcp-server
arabold
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that scrapes, indexes, and searches documentation for third-party software libraries and packages, supporting versioning and hybrid search.
Last updated -
231
129
TypeScript
MIT License

View all related MCP servers

Confluence MCP Server