9i.SrSSKJrJrJr SSKrSSKJr SSKJ r SSK J r \ "5r Sr "SS \5r"S S \5r"S S \5r"SS\5rg)z MCP (Model Context Protocol) API interface for ModelScope Hub. This module provides a simple interface to interact with ModelScope MCP plaza (https://www.modelscope.cn/mcp). )AnyDictOptionalN)HubApi)raise_for_http_status) get_loggerz/openapi/v1/mcp/serversc\rSrSrSrSrg) MCPApiErrorz"Base exception for MCP API errors.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r V/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/modelscope/hub/mcp_api.pyr r s,rr c\rSrSrSrSrg)MCPApiRequestErrorz,Exception raised when MCP API request fails.r Nr r rrrrs6rrc\rSrSrSrSrg)MCPApiResponseError!z2Exception raised when MCP API response is invalid.r Nr r rrrr!s<rrc <^\rSrSrSrSS\\SS4U4Sjjjr\S\ RS\ \\ 44Sj5r \S \S\4S j5rSS \\S \\ \\ 4S \\S\\S\ \\ 44 SjjrSS \S\ \\ 44SjjrSS \S \\S\ \\ 44SjjrSrU=r$)MCPApi&a= MCP (Model Context Protocol) API interface class. This class provides interfaces to interact with ModelScope MCP servers, such as to list, deploy and manage MCP servers. Note: MCPApi inherits login() from HubApi for authentication. Different methods have different token requirements - see individual method docs. NendpointreturncP>[TU]US9 UR[-Ulg)zs Initialize MCP API. Args: endpoint: The modelscope server address. Defaults to None (uses default endpoint). )rN)super__init__r MCP_API_PATH mcp_base_url)selfr __class__s rr#MCPApi.__init__1s& (+ MML8rrc&UR5nURS05$![RRaNn[R SU35 [R SUR 35 [SU35UeSnAff=f)z Handle HTTP response with unified error handling and JSON parsing. Args: r: requests Response object Returns: Parsed response data dict Raises: MCPApiResponseError: If JSON parsing fails zJSON parsing failed: zResponse content: zInvalid JSON response: Ndata) jsonrequests exceptionsJSONDecodeErrorloggererrortextrget)r)respes r_handle_responseMCPApi._handle_response<s L668D xx## ""22 L LL04 5 LL-affX6 7%(?s&CD! K Ls$BA B  B server_idc<SU;aURSS5S$U$)z#Extract server name from server ID./)split)r8s r_get_server_name_from_idMCPApi._get_server_name_from_idSs( ) ??3*1- -rtokenfilter total_countsearchc Ub US:dUS:a [S5eU=(d 0SUUS.nURU5nURRURUR UR 5UUS9n[U5 URU5n U RS /5n U V s/sH9n U RS S 5U RS S 5U RS S 5S.PM; n n U RSS5U S.$![RRa*n[RSU5 [SU35UeSnAff=fs sn f)a List available MCP servers, if (optional) token is presented, this would return private MCP servers as well. Args: token: Optional access token for authentication filter: Optional filters to apply to the search - 'category': str, server category, e.g. 'communication' - 'tag': str, server tag, e.g. 'social-media' - 'is_hosted': bool, server is hosted When all three are passed in, the intersection is taken. total_count: Number of servers to return, max 100, default 20 search: Optional search query string,e.g. Chinese service name, English service name, author/owner username You can combine `filter` and `search` to retrieve desired MCP servers. Returns: Dict containing: - total_count: Total number of servers - servers: List of server dictionaries with name, id, description Raises: MCPApiRequestError: If API request fails (network, server errors) MCPApiResponseError: If response format is invalid or JSON parsing fails Authentication: Optional, only required if you wish to retrieve private MCP servers. You may leverage the token parameter for one-time authentication, or use api.login() Returns: { 'total_count': 20, 'servers': [ {'name': 'ServerA', 'id': '@demo/ServerA', 'description': 'This is a demo server for xxx.'}, {'name': 'ServerB', 'id': '@demo/ServerB', 'description': 'This is another demo server.'}, ... ] } Nr;dz%total_count must be between 1 and 100)r@ page_number page_sizerB)urlheadersr,cookieszFailed to get MCP servers: %szFailed to get MCP servers: mcp_server_listnameid description)rKrMrNrArrAservers) ValueError get_cookiessessionputr%builder_headersrHrr-r.RequestExceptionr0r1rr6r3) r&r?r@rArBbodyrIr)r5r+rJitemmcp_config_lists rlist_mcp_serversMCPApi.list_mcp_serversZsqV  +/[35FDE El$   O&&u-G   %%,,T\\: !!A "! $ $$Q'((#4b9 & '&dHHVR(((4$88M26 & ' 88M15&  ""33 O LL8! <$'B1#%FGQ N O 'sAD.AEE #%EE c URS3nURUR5nURUSS9nURR X#US9n[ U5 [RSUR35 URU5nUR S/5n/n UHn 0n U R S S 5U S 'U R S S 5U S 'U R S S 5U S '/U S 'U R S/5HKn U S R!U R S5R#S5SU R SS 5S.5 MM U R!U 5 M UR SS5U S.$![RRa,n[RSU35 [SU35UeSnAff=f)aQ Get list of operational MCP servers that have been triggered hosting service by the user. Returns: Dict containing: - total_counts: Total number of operational servers - servers: List of server info with name, id, description Raises: MCPApiRequestError: If authentication fails or API request fails MCPApiResponseError: If response format is invalid or JSON parsing fails Returns: { 'total_count': 10, 'servers': [ { 'name': 'ServerA', "id": "@Group1/ServerA", 'description': 'This is a demo server for xxx.' 'mcp_servers': [ { 'type': 'sse', 'url': 'https://mcp.api-inference.modelscope.net/{uuid}/sse' }, { 'type': 'streamable_http', 'url': 'https://mcp.api-inference.modelscope.net/{uuid}/streamable_http' }, ... ] }, ... ] } z /operationalT) access_tokencookies_required)rHrIz'Failed to get operational MCP servers: NzResponse status code: rJrKrLrMrN mcp_serversoperational_urlsrGr:typerGrArrO)r%rUrHrRrSr3rr-r.rVr0r1rdebug status_coder6appendr<) r&r?rGrHrIr)r5r+rJrYrX mcp_configoperational_urls rlist_operational_mcp_servers#MCPApi.list_operational_mcp_serverssL""#<0&&t||4 F&&"T';G   w GA !! $  -amm_=>$$Q'((#4b9#DJ!%&"!5Jv #xxb1Jt (,(CJ} %(*J} %#'88,>#C=)00#''.44S9"=#''r2 2$D  " ": .$ 88M15&  3""33 F LLB1#F G$9!=?DE F Fs5E>>G'GGcfU(d [S5eURSU3nURUR5nUR U5nUR R UUSS0US9n[U5 URU5nUR S S 5UR S S 5UR S S 5S .n UR S S 5n[R!U5n UR S/5n /n U (aWU (aPU HJn U R S5R#S5SU R SS 5S.nU R%U5 ML XS'U $![RRa2n[RSUSU35 [SUSU35UeSnAff=f)aM Get detailed information for a specific MCP Server, a valid token shall be provided if the MCP server is private. Args: server_id: MCP server ID (e.g., "@amap/amap-maps") token: Optional access token for authentication Returns: Dict containing: - name: Server name - description: Server description - id: Server ID - service_config: Connection configuration with type and url Raises: ValueError: If server_id is empty or None MCPApiRequestError: If API request fails or server not found MCPApiResponseError: If response format is invalid or JSON parsing fails Returns: { 'name': 'ServerA', 'description': 'This is a demo server for xxx.', 'id': '@demo/serverA', 'servers': [ { 'type': 'sse', 'url': 'https://mcp.api-inference.modelscope.net/{uuid}/sse' }, { 'type': 'streamable_http', 'url': 'https://mcp.api-inference.modelscope.net/{uuid}/streamable_http' } ... ] } zserver_id cannot be emptyr:get_operational_urlT)rHparamsrIzFailed to get MCP server z: NrKrLrNrM)rKrNrMr`rGrarbrP)rQr%rUrHrRrSr3rr-r.rVr0r1rr6rr=r<rf)r&r8r?rGrHrIr)r5r+result server_namer`rYrhrgs rget_mcp_serverMCPApi.get_mcp_serversR89 9""#1YK0&&t||4 E&&u-G   - !!A "! $ $$Q'HHVR(88M26((4$  HHT2& 55i@ 88$6; +#3+//6<CD E Es:E F0>-F++F0)r%)N)NNrL)rrrrrrstrr# staticmethodr-Responserrr6r=intrZrirpr __classcell__)r's@rrr&s= 9# 9$ 9 9$H--$$sCx.$$,CC15<@6813 L ( L !)$sCx.!9L '/smL "*# L 9=S#X L ^37J ,/J ;?S>J \/3S"%S&smS7;CH~SSrr)rtypingrrrr-modelscope.hub.apirmodelscope.hub.errorsrmodelscope.utils.loggerrr0r$ Exceptionr rrrr rrr}s` '&%7. )  )    + aVar