get_confluence_page
Retrieve detailed content from Confluence pages by providing a page ID to access documentation and information stored in Confluence systems.
Instructions
获取 Confluence 页面详细信息
Args:
page_id: 页面ID
ctx: MCP 上下文
Returns:
Dict: 包含页面信息的字典
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page_id | Yes |
Implementation Reference
- servers/confluence_mcp.py:62-100 (handler)The main MCP tool handler for get_confluence_page. This async function is decorated with @mcp.tool() and handles the request, including logging, error handling, and calling the underlying confluence utility to fetch page content.
@mcp.tool() async def get_confluence_page( ctx: Context, page_id: Union[int, str], ) -> Dict: """ 获取 Confluence 页面详细信息 Args: page_id: 页面ID ctx: MCP 上下文 Returns: Dict: 包含页面信息的字典 """ try: await ctx.session.send_log_message( level="info", data=f"获取页面内容: page_id='{page_id}'" ) page_info = confluence.get_page_content(page_id) if not page_info: raise ValueError(f"未找到页面: {page_id}") return { "success": True, "page": page_info } except Exception as e: error_msg = f"获取页面失败: {str(e)}" await ctx.session.send_log_message( level="error", data=error_msg ) return { "success": False, "error": error_msg } - utils/confluence_utils.py:63-100 (helper)The core implementation logic that fetches page content from Confluence API. The get_page_content method uses the atlassian.Confluence client to retrieve page details with expanded fields including body, version, space, history, and labels.
def get_page_content(self, page_id): """ 获取页面的完整信息 :param page_id: 页面 ID :return: 包含页面详细信息的字典 """ page = self.confluence.get_page_by_id( page_id, expand='body.storage,version,space,history,metadata.labels' ) if not page: return None # 构建完整的页面信息 page_info = { 'id': page.get('id'), 'title': page.get('title'), 'space': { 'key': page.get('space', {}).get('key'), 'name': page.get('space', {}).get('name') }, 'version': page.get('version', {}).get('number'), 'content': page.get('body', {}).get('storage', {}).get('value'), 'url': self.page_url.format(page_id=page_id), 'created': { 'date': page.get('history', {}).get('createdDate'), 'by': page.get('history', {}).get('createdBy', {}).get('displayName') }, 'modified': { 'date': page.get('version', {}).get('when'), 'by': page.get('version', {}).get('by', {}).get('displayName') }, 'labels': [label.get('name') for label in page.get('metadata', {}).get('labels', {}).get('results', [])] } return page_info - servers/confluence_mcp.py:62-66 (registration)Tool registration using the @mcp.tool() decorator, which registers get_confluence_page as an available MCP tool with its signature and parameters.
@mcp.tool() async def get_confluence_page( ctx: Context, page_id: Union[int, str], ) -> Dict: