MPO MCP Server

Instructions

Implementation Reference

• mpo_mcp/server.py:112-122 (handler)

  MCP tool handler for 'confluence_list_pages'. Registers the tool using @mcp.tool() decorator and delegates execution to ConfluenceTools.list_pages() method.

  @mcp.tool()
  async def confluence_list_pages(
      space_key: Optional[str] = None, limit: int = 25
  ) -> list:
      """List pages in a Confluence space.
  
      Args:
          space_key: Space key (optional, defaults to CONFLUENCE_SPACE_KEY env var)
          limit: Maximum number of pages to return (default: 25)
      """
      return await confluence_tools.list_pages(space_key=space_key, limit=limit)

• mpo_mcp/confluence_tools.py:33-97 (helper)

  Core helper method implementing the logic to list pages in a Confluence space using the Atlassian Confluence Python client library. Called by the MCP handler.

  async def list_pages(
      self,
      space_key: Optional[str] = None,
      limit: int = 25,
      expand: Optional[str] = None,
  ) -> List[Dict[str, Any]]:
      """
      List pages in a Confluence space.
  
      Args:
          space_key: Space key (defaults to CONFLUENCE_SPACE_KEY env var)
          limit: Maximum number of pages to return
          expand: Optional expand parameters (e.g., "body.storage,version")
  
      Returns:
          List of page information
      """
      self._check_client()
  
      try:
          space_key = space_key or Config.CONFLUENCE_SPACE_KEY
          if not space_key:
              raise ValueError("Space key is required")
  
          pages = self.client.get_all_pages_from_space(
              space=space_key,
              start=0,
              limit=limit,
              expand=expand,
          )
  
          results = []
          for page in pages:
              page_data = {
                  "id": page.get("id"),
                  "title": page.get("title"),
                  "type": page.get("type"),
                  "status": page.get("status"),
              }
  
              # Add URL
              if "_links" in page and "webui" in page["_links"]:
                  page_data["url"] = (
                      f"{Config.CONFLUENCE_URL}{page['_links']['webui']}"
                  )
  
              # Add version if available
              if "version" in page:
                  page_data["version"] = page["version"].get("number")
  
              # Add space info
              if "space" in page:
                  page_data["space"] = {
                      "key": page["space"].get("key"),
                      "name": page["space"].get("name"),
                  }
  
              results.append(page_data)
  
          return results
  
      except Exception as e:
          logger.error(f"Confluence API error: {e}")
          raise ValueError(f"Failed to list pages: {str(e)}")

• llm_assistant.py:155-168 (schema)

  Explicit JSON schema definition for the 'confluence_list_pages' tool input, used in the LLM assistant for tool calling with Anthropic Claude.

  {
      "name": "confluence_list_pages",
      "description": "List pages in a Confluence space",
      "input_schema": {
          "type": "object",
          "properties": {
              "space_key": {"type": "string", "description": "Space key"},
              "limit": {
                  "type": "integer",
                  "description": "Maximum pages",
                  "default": 25,
              },
          },
      },