6pj-SrSSKJrJrJr SSKrSSKJr SSKJ r J 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) RequestErrorraise_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 R/var/www/html/pdf-tiff/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 Nrr rrrrs6rrc\rSrSrSrSrg)MCPApiResponseError!z2Exception raised when MCP API response is invalid.r Nrr rrrr!s<rrc ^\rSrSrSrSS\\S\\SS4U4Sjjjr\S\S\4S j5r SS\\S \\ \\ 4S \\ S \\S\ \\ 44 S jjr SS\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. NendpointtokenreturncP>[TU]XS9 UR[-Ulg)z Initialize MCP API. Args: endpoint: The modelscope server address. Defaults to None (uses default endpoint). token: Optional access token for Bearer authentication. )r r!N)super__init__r MCP_API_PATH mcp_base_url)selfr r! __class__s rr%MCPApi.__init__1s& (8 MML8r server_idc<SU;aURSS5S$U$)z#Extract server name from server ID./)split)r+s r_get_server_name_from_idMCPApi._get_server_name_from_id?s( ) ??3*1- -rfilter total_countsearchc Ub US:dUS:a [S5eU=(d 0SUUS.nURUSS9nURRURXeS9n[ U5 URU5n U RS /5n U V s/sH9n U RS S5U RSS5U RSS5S.PM; n n U RSS5U S.$![ RRa*n[RS U5 [S U35UeSnAff=f![an[S U35UeSnAff=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)r2 page_number page_sizer4Fr!token_required)urlheadersjsonzFailed to get MCP servers: %szFailed to get MCP servers: z(Invalid response from MCP servers list: mcp_server_listnameid description)r?rArBr3rr3servers) ValueError_build_bearer_headerssessionputr'rrequests exceptionsRequestExceptionloggererrorr_parse_openapi_responserrget) r(r!r2r3r4bodyr<redatar>itemmcp_config_lists rlist_mcp_serversMCPApi.list_mcp_serversFsV  +/[35FDE El$   O00E13G   %%w!CA !! $  G//2D ((#4b9 & '&dHHVR(((4$88M26 & ' 88M15&  #""33 O LL8! <$'B1#%FGQ N O  G%:1#>@EF G G 's6?C*,D5AE*D2%D--D25 E?EEc URS3nURUSS9nURRX#S9n[ U5 [RSUR35 URU5nURS /5n/nUHn 0n U RS S 5U S 'U RS S 5U S 'U RS S 5U S '/U S'U RS/5HTn U SR!U RS5=(d S R#S5SU RSS 5S.5 MV UR!U 5 M URSS5US.$![ R Ra,n[RSU35 [SU35UeSnAff=f![an[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 /operationalTr9)r<z'Failed to get operational MCP servers: NzResponse status code: z/Invalid response from operational MCP servers: r>r?r@rArB mcp_serversoperational_urlsr;r-typer;r3rrC)r'rFrGrOrrIrJrKrLrMrdebug status_coderNrrappendr/) r(r!r;r<rQrRrSr>rUrT mcp_configoperational_urls rlist_operational_mcp_servers#MCPApi.list_operational_mcp_serverssL""#<0 F00D12G    6A !! $  -amm_=> N//2D ((#4b9#DJ!%&"!5Jv #xxb1Jt (,(CJ} %(*J} %#'88,>#C=)00,007=2DDSI"M#''r22$D  " ": .$ 88M15&  ;""33 F LLB1#F G$9!=?DE F F N%A!EGLM N Ns/4E,(F9,F6 'F11F69 GGGcU(d [S5eURSU3nURUSS9nURR X4SS0S9n[ U5 URU5nUR S S 5UR SS 5UR SS 5S.nUR SS 5n[R!U5n UR S/5n /n U (a`U (aYU HSn U R S5=(d S R#S5SU R SS 5S.n U R%U 5 MU XS'U$![ RRa2n[RSUS U35 [SUS U35UeS nAff=f![an[S US U35UeS nAff=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-Fr9get_operational_urlT)r<paramszFailed to get MCP server z: Nz!Invalid response from MCP server r?r@rBrA)r?rBrArZr;r[r\rD)rEr'rFrGrOrrIrJrKrLrMrrNrrrr0r/r`)r(r+r!r;r<rQrRrSresult server_namerZrUrbras rget_mcp_serverMCPApi.get_mcp_serversR89 9""#1YK0 E00E13G   .CT-J!LA !! $  M//2D HHVR(88M26((4$  HHT2& 55i@ 88$6; +#3,007=2DDSI"M*..ub9  &&z2 $4,y ?""33 E LL4YKr!E F$+I;b<>CD E E M%3I;bDFKL M Ms/7E F F*-FF G)F;;G)r')NN)NNr@)N)rrrrrrstrr% staticmethodr0rrintrVrcrjr __classcell__)r)s@rrr&s#,0(, 9#C= 9   915 9 9CC15<@6813 O ( O !)$sCx.!9O '/smO "*# O 9=S#X O d37M ,/M ;?S>M b/3S"%S&smS7;CH~SSrr)rtypingrrrrImodelscope.hub.apirmodelscope.hub.errorsrrmodelscope.utils.loggerr rLr& Exceptionr rrrr rrrvs` '&%E. )  )    + SVSr