Polarion MCP Server

Instructions

Implementation Reference

• polarion_mcp/server.py:165-200 (handler)

  MCP tool handler for get_polarion_project: decorated with @mcp.tool(), validates inputs implicitly via types, calls PolarionClient.get_project(), and returns formatted JSON response.
  @mcp.tool() def get_polarion_project(project_id: str, fields: str = "@basic") -> str: """ <purpose>Get detailed information about a specific Polarion project</purpose> <when_to_use> - When you need detailed project metadata (description, settings, etc.) - After using get_polarion_projects() to identify the project_id - When you need project configuration details - RARELY needed for most exploration tasks </when_to_use> <workflow_position> OPTIONAL: Use after get_polarion_projects() if project details are needed USUALLY SKIP: Most tasks should go directly to get_polarion_work_items() </workflow_position> <parameters> - project_id: Exact project ID from get_polarion_projects() results - fields: "@basic" for essential info, "@all" for complete details </parameters> <note>Most users should skip this and go directly to exploring work items</note> """ logger.info(f"Fetching project {project_id} from Polarion") project = polarion_client.get_project(project_id, fields) if project: return json.dumps({ "status": "success", "message": f"Successfully fetched project: {project_id}", "project": project }, indent=2) return json.dumps({ "status": "error", "message": f"Failed to fetch project {project_id}. Project may not exist or access is denied." }, indent=2)
• polarion_mcp/client.py:172-188 (helper)

  Core helper method in PolarionClient that executes the REST API call to retrieve specific project details from Polarion, handles authentication, errors, and returns project data.
  def get_project(self, project_id: str, fields: str = "@basic") -> Optional[Dict]: """Fetch specific project details from Polarion REST API.""" try: self._ensure_token() api_url = f"{POLARION_BASE_URL}/rest/v1/projects/{project_id}" params = {'fields[projects]': fields} response = self.session.get(api_url, params=params, headers=self._headers(), timeout=REQUEST_TIMEOUT_SECONDS) if response.status_code == 404: logger.warning(f"Project not found: {project_id}") return None self._handle_api_response(response, f"fetch project {project_id}") project_data = response.json() logger.info(f"Fetched project: {project_id}") return project_data except Exception as e: logger.error(f"Failed to fetch project {project_id}: {e}") return None
• polarion_mcp/server.py:165-165 (registration)

  The @mcp.tool() decorator registers this function as an MCP tool named 'get_polarion_project' based on function name.
  @mcp.tool()
• polarion_mcp/server.py:166-166 (schema)

  Function signature defines input schema: required project_id (str), optional fields (str, default '@basic'), output str (JSON).
  def get_polarion_project(project_id: str, fields: str = "@basic") -> str: