alibaba-cloud-ops-mcp-server 0.8.7__tar.gz → 0.8.9__tar.gz

alibaba_cloud_ops_mcp_server-0.8.9/.github/workflows/python-ci.yml

@@ -0,0 +1,28 @@
+name: unit test
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        run: |
+          pip install uv
+      - name: Run tests with coverage
+        env:
+          PYTHONPATH: src
+        run: |
+          uv run pytest --cov=src --cov-report=term-missing 

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/.gitignore

@@ -5,6 +5,7 @@ build/
 dist/
 wheels/
 *.egg-info
+.coverage
 
 # Virtual environments
 .venv

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alibaba-cloud-ops-mcp-server
-Version: 0.8.7
+Version: 0.8.9
 Summary: A MCP server for Alibaba Cloud
 Author-email: Zheng Dayu <dayu.zdy@alibaba-inc.com>
 License-File: LICENSE
@@ -58,16 +58,19 @@ To use `alibaba-cloud-ops-mcp-server` MCP Server with any other MCP Client, you
 ## MCP Maketplace Integration
 
 * [Cline](https://cline.bot/mcp-marketplace)
+* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElEIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTRUNSRVQifX0%3D)
 * [ModelScope](https://www.modelscope.cn/mcp/servers/@aliyun/alibaba-cloud-ops-mcp-server?lang=en_US)
 * [Lingma](https://lingma.aliyun.com/)
 * [Smithery AI](https://smithery.ai/server/@aliyun/alibaba-cloud-ops-mcp-server)
 * [FC-Function AI](https://cap.console.aliyun.com/template-detail?template=237)
+* [Alibaba Cloud Model Studio](https://bailian.console.aliyun.com/?tab=mcp#/mcp-market/detail/alibaba-cloud-ops)
 
 ## Know More
 
-* [Alibaba Cloud MCP Server is ready to use out of the box!！](https://developer.aliyun.com/article/1661348)
-* [Setup Alibaba Cloud MCP Server on Bailian](https://developer.aliyun.com/article/1662120)
+* [Alibaba Cloud Ops MCP Server is ready to use out of the box!！](https://developer.aliyun.com/article/1661348)
+* [Setup Alibaba Cloud Ops MCP Server on Bailian](https://developer.aliyun.com/article/1662120)
 * [Build your own Alibaba Cloud OpenAPI MCP Server with 10 lines of code](https://developer.aliyun.com/article/1662202)
+* [Alibaba Cloud Ops MCP Server is officially available on the Alibaba Cloud Model Studio Platform MCP Marketplace](https://developer.aliyun.com/article/1665019)
 
 ## Tools
 

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/README.md

@@ -42,16 +42,19 @@ To use `alibaba-cloud-ops-mcp-server` MCP Server with any other MCP Client, you
 ## MCP Maketplace Integration
 
 * [Cline](https://cline.bot/mcp-marketplace)
+* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElEIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTRUNSRVQifX0%3D)
 * [ModelScope](https://www.modelscope.cn/mcp/servers/@aliyun/alibaba-cloud-ops-mcp-server?lang=en_US)
 * [Lingma](https://lingma.aliyun.com/)
 * [Smithery AI](https://smithery.ai/server/@aliyun/alibaba-cloud-ops-mcp-server)
 * [FC-Function AI](https://cap.console.aliyun.com/template-detail?template=237)
+* [Alibaba Cloud Model Studio](https://bailian.console.aliyun.com/?tab=mcp#/mcp-market/detail/alibaba-cloud-ops)
 
 ## Know More
 
-* [Alibaba Cloud MCP Server is ready to use out of the box!！](https://developer.aliyun.com/article/1661348)
-* [Setup Alibaba Cloud MCP Server on Bailian](https://developer.aliyun.com/article/1662120)
+* [Alibaba Cloud Ops MCP Server is ready to use out of the box!！](https://developer.aliyun.com/article/1661348)
+* [Setup Alibaba Cloud Ops MCP Server on Bailian](https://developer.aliyun.com/article/1662120)
 * [Build your own Alibaba Cloud OpenAPI MCP Server with 10 lines of code](https://developer.aliyun.com/article/1662202)
+* [Alibaba Cloud Ops MCP Server is officially available on the Alibaba Cloud Model Studio Platform MCP Marketplace](https://developer.aliyun.com/article/1665019)
 
 ## Tools
 

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/README_zh.md

@@ -42,16 +42,19 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 ## MCP市场集成
 
 * [Cline](https://cline.bot/mcp-marketplace)
+* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElEIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTRUNSRVQifX0%3D)
 * [魔搭](https://www.modelscope.cn/mcp/servers/@aliyun/alibaba-cloud-ops-mcp-server)
 * [通义灵码](https://lingma.aliyun.com/)
 * [Smithery AI](https://smithery.ai/server/@aliyun/alibaba-cloud-ops-mcp-server)
 * [FC-Function AI](https://cap.console.aliyun.com/template-detail?template=237)
+* [阿里云百炼平台](https://bailian.console.aliyun.com/?tab=mcp#/mcp-market/detail/alibaba-cloud-ops)
 
 ## 了解更多
 
 * [阿里云 MCP Server 开箱即用！](https://developer.aliyun.com/article/1661348)
 * [在百炼平台配置您的自定义阿里云MCP Server](https://developer.aliyun.com/article/1662120)
 * [10行代码，实现你的专属阿里云OpenAPI MCP Server](https://developer.aliyun.com/article/1662202)
+* [阿里云CloudOps MCP正式上架百炼平台MCP市场](https://developer.aliyun.com/article/1665019)
 
 ## 功能点（Tool）
 

alibaba_cloud_ops_mcp_server-0.8.9/examples/openapi_mcp_quickstart/server.py

@@ -0,0 +1,17 @@
+# Build your own Alibaba Cloud OpenAPI MCP Server with 10 lines of code
+# https://developer.aliyun.com/article/1662202
+# example codes
+from mcp.server.fastmcp import FastMCP
+from alibaba_cloud_ops_mcp_server.tools import api_tools
+
+def main():
+    mcp = FastMCP("Example MCP server")
+    config = {
+        'ecs': ['DescribeInstances', 'DescribeRegions'],
+        'vpc': ['DescribeVpcs', 'DescribeVSwitches']
+    }
+    api_tools.create_api_tools(mcp, config)
+    mcp.run(transport='sse')
+
+if __name__ == "__main__":
+    main()

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "alibaba-cloud-ops-mcp-server"
-version = "0.8.7"
+version = "0.8.9"
 description = "A MCP server for Alibaba Cloud"
 readme = "README.md"
 authors = [
@@ -27,5 +27,11 @@ dependencies = [
 [tool.hatch.build.targets.wheel]
 packages = ["src/alibaba_cloud_ops_mcp_server"]
 
+[dependency-groups]
+dev = [
+    "pytest>=8.4.0",
+    "pytest-cov>=6.1.1",
+]
+
 [project.scripts]
 alibaba-cloud-ops-mcp-server = "alibaba_cloud_ops_mcp_server:main"

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/src/alibaba_cloud_ops_mcp_server/alibabacloud/api_meta_client.py

@@ -30,12 +30,13 @@ class ApiMetaClient:
 
     @classmethod
     def get_response_from_pop_api(cls, pop_api_name, service=None, api=None, version=None):
+        url = None  # 提前定义，防止 except 中引用未定义变量
         try:
             api_config = cls.config.get(pop_api_name)
             try:
                 formatted_path = api_config[cls.PATH].format(service=service, api=api, version=version)
             except KeyError as e:
-                raise Exception(f'Failed to format path, path: {api_config[cls.PATH]}, error: {e}')
+                raise Exception(f'Failed to format path, path: {api_config.get(cls.PATH)}, error: {e}')
 
             url = f'{cls.BASE_URL}/{formatted_path}'
             response = requests.get(url)

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/src/alibaba_cloud_ops_mcp_server/server.py

@@ -21,11 +21,18 @@ logger = logging.getLogger(__name__)
     default=8000,
     help="Port number",
 )
-def main(transport: str, port: int):
+@click.option(
+    "--host",
+    type=str,
+    default="127.0.0.1",
+    help="Host",
+)
+def main(transport: str, port: int, host: str):
     # Create an MCP server
     mcp = FastMCP(
         name="alibaba-cloud-ops-mcp-server",
-        port=port
+        port=port,
+        host=host
     )
     for tool in oos_tools.tools:
         mcp.add_tool(tool)

{alibaba_cloud_ops_mcp_server-0.8.7 → alibaba_cloud_ops_mcp_server-0.8.9}/src/alibaba_cloud_ops_mcp_server/tools/api_tools.py

@@ -2,6 +2,7 @@ import os
 from mcp.server.fastmcp import FastMCP, Context
 from pydantic import Field
 import logging
+import json
 
 import inspect
 import types
@@ -32,6 +33,15 @@ def create_client(service: str, region_id: str) -> OpenApiClient:
     return OpenApiClient(config)
 
 
+# 类型为String的JSON数组参数
+ECS_LIST_PARAMETERS = {
+    'HpcClusterIds', 'DedicatedHostClusterIds', 'DedicatedHostIds', 
+    'InstanceIds', 'DeploymentSetIds', 'KeyPairNames', 'SecurityGroupIds', 
+    'diskIds', 'repeatWeekdays', 'timePoints', 'DiskIds', 'SnapshotLinkIds', 
+    'EipAddresses', 'PublicIpAddresses', 'PrivateIpAddresses'
+}
+
+
 def _tools_api_call(service: str, api: str, parameters: dict, ctx: Context):
     service = service.lower()
     api_meta, _ = ApiMetaClient.get_api_meta(service, api)
@@ -39,8 +49,16 @@ def _tools_api_call(service: str, api: str, parameters: dict, ctx: Context):
     method = 'POST' if api_meta.get('methods', [])[0] == 'post' else 'GET'
     path = api_meta.get('path', '/')
     style = ApiMetaClient.get_service_style(service)
+    
+    # 处理特殊参数格式
+    processed_parameters = parameters.copy()
+    if service == 'ecs':
+        for param_name, param_value in parameters.items():
+            if param_name in ECS_LIST_PARAMETERS and isinstance(param_value, list):
+                processed_parameters[param_name] = json.dumps(param_value)
+    
     req = open_api_models.OpenApiRequest(
-        query=OpenApiUtilClient.query(parameters)
+        query=OpenApiUtilClient.query(processed_parameters)
     )
     params = open_api_models.Params(
         action=api,
@@ -53,7 +71,7 @@ def _tools_api_call(service: str, api: str, parameters: dict, ctx: Context):
         req_body_type='formData',
         body_type='json'
     )
-    client = create_client(service, parameters.get('RegionId', 'cn-hangzhou'))
+    client = create_client(service, processed_parameters.get('RegionId', 'cn-hangzhou'))
     runtime = util_models.RuntimeOptions()
     return client.call_api(params, req, runtime)
 
@@ -75,9 +93,15 @@ def _create_function_schemas(service, api, api_meta):
         description = schema.get('description', '')
         example = schema.get('example', '')
         type_ = schema.get('type', '')
-        description = f'{description} 请注意，提供参数要严格按照参数的类型和参数示例的提示，如果提到参数为String，且为一个 JSON 数组字符串，应在数组内使用单引号包裹对应的参数以避免转义问题，并在最外侧用双引号包裹以确保其是字符串，否则可能会导致参数解析错误。参数类型: {type_},参数示例：{example}'
+        description = f'{description} 参数类型: {type_},参数示例：{example}'
         required = schema.get('required', False)
-        python_type = type_map.get(type_, str)
+        
+        # 只有在service为ecs时，才对特定参数进行特殊处理
+        if service.lower() == 'ecs' and name in ECS_LIST_PARAMETERS and type_ == 'string':
+            python_type = list
+        else:
+            python_type = type_map.get(type_, str)
+            
         field_info = (
             python_type,
             field(

alibaba_cloud_ops_mcp_server-0.8.9/tests/alibabacloud/test_api_meta_client.py

@@ -0,0 +1,292 @@
+import pytest
+from unittest.mock import patch, MagicMock
+from alibaba_cloud_ops_mcp_server.alibabacloud import api_meta_client
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_response_from_pop_api_success(mock_get):
+    mock_get.return_value.json.return_value = [{"code": "ecs", "defaultVersion": "2014-05-26", "style": "RPC"}]
+    data = api_meta_client.ApiMetaClient.get_response_from_pop_api('GetProductList')
+    assert isinstance(data, list)
+    assert data[0]["code"] == "ecs"
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_response_from_pop_api_exception(mock_get):
+    mock_get.side_effect = Exception('fail')
+    with pytest.raises(Exception) as e:
+        api_meta_client.ApiMetaClient.get_response_from_pop_api('GetProductList')
+    assert 'Failed to get response' in str(e.value)
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_service_version_and_style(mock_get):
+    mock_get.return_value.json.return_value = [{"code": "ecs", "defaultVersion": "2014-05-26", "style": "RPC"}]
+    v = api_meta_client.ApiMetaClient.get_service_version('ecs')
+    s = api_meta_client.ApiMetaClient.get_service_style('ecs')
+    assert v == "2014-05-26"
+    assert s == "RPC"
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_standard_service_and_api(mock_get):
+    # 1st call: GetProductList, 2nd call: GetApiOverview
+    mock_get.return_value.json.side_effect = [
+        [{"code": "ecs", "defaultVersion": "2014-05-26"}],
+        {"apis": {"DescribeInstances": {}}}
+    ]
+    service, api = api_meta_client.ApiMetaClient.get_standard_service_and_api('ecs', 'DescribeInstances', '2014-05-26')
+    assert service == 'ecs'
+    assert api == 'DescribeInstances'
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_api_meta_invalid(mock_get):
+    # 1st call: GetProductList returns empty list
+    mock_get.return_value.json.return_value = []
+    with pytest.raises(Exception) as e:
+        api_meta_client.ApiMetaClient.get_api_meta('notexist', 'api')
+    assert 'InvalidServiceName' in str(e.value) or 'object has no attribute' in str(e.value)
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_service_version', return_value='2014-05-26')
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=(None, 'api'))
+def test_get_api_meta_service_none(mock_get_std, mock_get_ver):
+    with pytest.raises(Exception) as e:
+        api_meta_client.ApiMetaClient.get_api_meta('ecs', 'DescribeInstances')
+    assert 'InvalidServiceName' in str(e.value)
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_service_version', return_value='2014-05-26')
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=('ecs', None))
+def test_get_api_meta_api_none(mock_get_std, mock_get_ver):
+    with pytest.raises(Exception) as e:
+        api_meta_client.ApiMetaClient.get_api_meta('ecs', 'DescribeInstances')
+    assert 'InvalidAPIName' in str(e.value)
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta', return_value=({}, '2014-05-26'))
+def test_get_response_from_api_meta_empty(mock_get_meta):
+    prop, ver = api_meta_client.ApiMetaClient.get_response_from_api_meta('ecs', 'DescribeInstances')
+    assert prop == {}
+    assert ver == '2014-05-26'
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=('ecs', 'api'))
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_response_from_pop_api')
+def test_get_ref_api_meta_keyerror(mock_pop_api, mock_std):
+    # ref_path指向不存在的key
+    mock_pop_api.return_value = {'apis': {}}
+    with pytest.raises(KeyError):
+        api_meta_client.ApiMetaClient.get_ref_api_meta({'$ref': '#/notfound'}, 'ecs', '2014-05-26')
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta')
+def test_get_api_parameters_params_in_and_ref(mock_get_meta):
+    # 测试params_in过滤和递归ref
+    api_meta = {
+        'parameters': [
+            {'name': 'foo', 'in': 'query', 'schema': {'type': 'string'}},
+            {'name': 'bar', 'in': 'body', 'schema': {'type': 'string', '$ref': '#/defs/bar'}}
+        ]
+    }
+    # get_ref_api_meta返回递归结构
+    with patch.object(api_meta_client.ApiMetaClient, 'get_ref_api_meta', return_value={'properties': {'baz': {}}}):
+        mock_get_meta.return_value = (api_meta, '2014-05-26')
+        params = api_meta_client.ApiMetaClient.get_api_parameters('ecs', 'DescribeInstances', params_in='query')
+        assert params == ['foo']
+        # 测试递归ref
+        params2 = api_meta_client.ApiMetaClient.get_api_parameters('ecs', 'DescribeInstances')
+        assert 'baz' in params2
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta')
+def test_get_api_parameters_circular_ref(mock_get_meta):
+    # 测试循环引用
+    api_meta = {
+        'parameters': [
+            {'name': 'foo', 'in': 'query', 'schema': {'type': 'string', '$ref': '#/defs/foo'}}
+        ]
+    }
+    # get_ref_api_meta返回带$ref的结构，模拟循环
+    def fake_get_ref(data, service, version):
+        return {'$ref': '#/defs/foo'}
+    with patch.object(api_meta_client.ApiMetaClient, 'get_ref_api_meta', side_effect=fake_get_ref):
+        mock_get_meta.return_value = (api_meta, '2014-05-26')
+        params = api_meta_client.ApiMetaClient.get_api_parameters('ecs', 'DescribeInstances')
+        assert 'foo' in params
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta', side_effect=Exception('fail'))
+def test_get_api_field_exception(mock_get_meta):
+    val = api_meta_client.ApiMetaClient.get_api_field('parameters', 'ecs', 'DescribeInstances', default='d')
+    assert val == 'd'
+
+def test_get_api_body_style_none():
+    # get_api_field返回None
+    with patch.object(api_meta_client.ApiMetaClient, 'get_api_field', return_value=None):
+        val = api_meta_client.ApiMetaClient.get_api_body_style('ecs', 'DescribeInstances')
+        assert val is None
+    # get_api_field返回无STYLE参数
+    with patch.object(api_meta_client.ApiMetaClient, 'get_api_field', return_value=[{'in': 'body'}]):
+        val = api_meta_client.ApiMetaClient.get_api_body_style('ecs', 'DescribeInstances')
+        assert val is None
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_apis_in_service(mock_get):
+    mock_get.return_value.json.return_value = {"apis": {"A": {}, "B": {}}}
+    apis = api_meta_client.ApiMetaClient.get_apis_in_service('ecs', '2014-05-26')
+    assert set(apis) == {"A", "B"}
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_response_from_pop_api_keyerror(mock_get):
+    # config 缺 key
+    with patch.object(api_meta_client.ApiMetaClient, 'config', {'GetProductList': {}}):
+        with pytest.raises(Exception) as e:
+            api_meta_client.ApiMetaClient.get_response_from_pop_api('GetProductList')
+        assert 'Failed to format path' in str(e.value)
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta', return_value=({}, '2014-05-26'))
+def test_get_response_from_api_meta_no_properties(mock_get_meta):
+    # property_values 取不到属性
+    with patch.dict('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.__dict__', {'RESPONSES': 'responses', 'HTTP_SUCCESS_CODE': '200', 'SCHEMA': 'schema', 'PROPERTIES': 'properties'}):
+        prop, ver = api_meta_client.ApiMetaClient.get_response_from_api_meta('ecs', 'DescribeInstances')
+        assert prop == {}
+        assert ver == '2014-05-26'
+
+def test_get_api_parameters_empty():
+    # parameters 为空
+    with patch.object(api_meta_client.ApiMetaClient, 'get_api_meta', return_value=({'parameters': []}, '2014-05-26')):
+        params = api_meta_client.ApiMetaClient.get_api_parameters('ecs', 'DescribeInstances')
+        assert params == []
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_apis_in_service_no_apis(mock_get):
+    mock_get.return_value.json.return_value = {}
+    with pytest.raises(KeyError):
+        api_meta_client.ApiMetaClient.get_apis_in_service('ecs', '2014-05-26')
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_api_parameters_schema_not_dict(mock_get):
+    # get_api_meta返回的schema不是dict
+    api_meta = {
+        'parameters': [
+            {'name': 'foo', 'in': 'query', 'schema': None},
+            {'name': 'bar', 'in': 'query', 'schema': 'notadict'}
+        ]
+    }
+    with patch.object(api_meta_client.ApiMetaClient, 'get_api_meta', return_value=(api_meta, '2014-05-26')):
+        params = api_meta_client.ApiMetaClient.get_api_parameters('ecs', 'DescribeInstances')
+        # 两个参数都应该被返回
+        assert 'foo' in params
+        assert 'bar' in params
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_apis_in_service_normal(mock_get):
+    """测试get_apis_in_service方法正常返回API列表"""
+    mock_get.return_value.json.return_value = {"apis": {"DescribeInstances": {}, "StartInstance": {}}}
+    apis = api_meta_client.ApiMetaClient.get_apis_in_service('ecs', '2014-05-26')
+    assert set(apis) == {"DescribeInstances", "StartInstance"}
+    assert len(apis) == 2
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_service_version', return_value='2014-05-26')
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=(None, None))
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_response_from_pop_api')
+def test_get_api_meta_service_none_exception(mock_pop_api, mock_get_std, mock_get_ver):
+    """测试get_api_meta方法中service_standard为None时抛出异常"""
+    with pytest.raises(Exception) as e:
+        api_meta_client.ApiMetaClient.get_api_meta('ecs', 'DescribeInstances')
+    assert 'InvalidServiceName' in str(e.value)
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_service_version', return_value='2014-05-26')
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=('ecs', None))
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_response_from_pop_api')
+def test_get_api_meta_api_none_exception(mock_pop_api, mock_get_std, mock_get_ver):
+    """测试get_api_meta方法中api_standard为None时抛出异常"""
+    with pytest.raises(Exception) as e:
+        api_meta_client.ApiMetaClient.get_api_meta('ecs', 'DescribeInstances')
+    assert 'InvalidAPIName' in str(e.value)
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta')
+def test_get_api_parameters_schema_not_dict_more_cases(mock_get_meta):
+    """测试get_api_parameters中更多非dict类型的schema"""
+    api_meta = {
+        'parameters': [
+            {'name': 'foo', 'in': 'query', 'schema': 'string'},  # 字符串
+            {'name': 'bar', 'in': 'query', 'schema': 123},       # 数字
+            {'name': 'baz', 'in': 'query', 'schema': []},        # 列表
+            {'name': 'qux', 'in': 'query', 'schema': None},      # None
+        ]
+    }
+    mock_get_meta.return_value = (api_meta, '2014-05-26')
+    params = api_meta_client.ApiMetaClient.get_api_parameters('ecs', 'DescribeInstances')
+    assert 'foo' in params
+    assert 'bar' in params
+    assert 'baz' in params
+    assert 'qux' in params
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.requests.get')
+def test_get_apis_in_service_normal(mock_get):
+    """测试get_apis_in_service方法正常返回API列表"""
+    mock_get.return_value.json.return_value = {"apis": {"DescribeInstances": {}, "StartInstance": {}}}
+    apis = api_meta_client.ApiMetaClient.get_apis_in_service('ecs', '2014-05-26')
+    assert set(apis) == {"DescribeInstances", "StartInstance"}
+    assert len(apis) == 2
+
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=('ecs', 'api'))
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_response_from_pop_api')
+def test_get_ref_api_meta_invalid_path(mock_pop_api, mock_std):
+    # 模拟 ref_path 指向不存在的 key
+    mock_pop_api.return_value = {'apis': {'DescribeInstances': {}}}
+    with pytest.raises(KeyError):
+        api_meta_client.ApiMetaClient.get_ref_api_meta({'$ref': '#/notfound'}, 'ecs', '2014-05-26')
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=('ecs', 'api'))
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_response_from_pop_api')
+def test_get_ref_api_meta_invalid_path(mock_pop_api, mock_std):
+    # 模拟 ref_path 指向不存在的 key
+    mock_pop_api.return_value = {'apis': {'DescribeInstances': {}}}
+    with pytest.raises(KeyError):
+        api_meta_client.ApiMetaClient.get_ref_api_meta({'$ref': '#/notfound'}, 'ecs', '2014-05-26')
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta')
+def test_get_api_field_default_value(mock_get_meta):
+    # 模拟 get_api_meta 返回无 field_type 的数据
+    mock_get_meta.return_value = ({}, '2014-05-26')
+    val = api_meta_client.ApiMetaClient.get_api_field('parameters', 'ecs', 'DescribeInstances', default='default_val')
+    assert val == 'default_val'
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_api_meta')
+def test_get_api_parameters_nested_ref(mock_get_meta):
+    # 模拟嵌套 $ref
+    api_meta = {
+        'parameters': [
+            {'name': 'foo', 'in': 'query', 'schema': {'$ref': '#/defs/A'}}
+        ]
+    }
+    def fake_get_ref(data, service, version):
+        if '#/defs/A' in data.get('$ref', ''):
+            return {'properties': {'a': {'$ref': '#/defs/B'}}}
+        elif '#/defs/B' in data.get('$ref', ''):
+            return {'properties': {'b': {}}}
+        return {}
+    with patch.object(api_meta_client.ApiMetaClient, 'get_ref_api_meta', side_effect=fake_get_ref):
+        mock_get_meta.return_value = (api_meta, '2014-05-26')
+        params = api_meta_client.ApiMetaClient.get_api_parameters('ecs', 'DescribeInstances')
+        assert 'a' in params and 'b' in params  # 深层嵌套属性应被提取
+
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_standard_service_and_api', return_value=('ecs', 'api'))
+@patch('alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client.ApiMetaClient.get_response_from_pop_api')
+def test_get_ref_api_meta_valid_path(mock_pop_api, mock_std):
+    # 模拟 get_response_from_pop_api 返回包含 defs/A 的结构
+    mock_pop_api.return_value = {
+        'defs': {
+            'A': {
+                'properties': {
+                    'prop1': {'type': 'string'},
+                    'prop2': {'type': 'integer'}
+                }
+            }
+        }
+    }
+
+    # 调用 get_ref_api_meta，传入 $ref 指向 #/defs/A
+    result = api_meta_client.ApiMetaClient.get_ref_api_meta({'$ref': '#/defs/A'}, 'ecs', '2014-05-26')
+
+    # 验证返回结果是否与 defs/A 的结构一致
+    expected = {
+        'properties': {
+            'prop1': {'type': 'string'},
+            'prop2': {'type': 'integer'}
+        }
+    }
+    assert result == expected

alibaba_cloud_ops_mcp_server-0.8.9/tests/alibabacloud/test_exception.py

@@ -0,0 +1,36 @@
+import pytest
+from alibaba_cloud_ops_mcp_server.alibabacloud import exception
+
+def test_acs_exception_default():
+    e = exception.AcsException()
+    s = str(e)
+    assert 'InternalError' in s
+    assert 'unknown exception' in s.lower()
+    assert e.status == 500
+    assert e.code == 'InternalError'
+    assert isinstance(e.__deepcopy__({}), exception.AcsException)
+    assert isinstance(e.__unicode__(), str)
+
+def test_acs_exception_format():
+    class CustomEx(exception.AcsException):
+        msg_fmt = 'Error: {foo}.'
+        code = 'CustomError'
+    e = CustomEx(foo='bar')
+    assert 'bar' in str(e)
+    assert 'CustomError' in str(e)
+
+def test_acs_exception_format_keyerror(caplog):
+    class CustomEx(exception.AcsException):
+        msg_fmt = 'Error: {foo}.'
+        code = 'CustomError'
+    with caplog.at_level('ERROR'):
+        e = CustomEx(badkey='baz')
+        assert 'badkey' in caplog.text
+
+def test_oos_execution_failed():
+    e = exception.OOSExecutionFailed(reason='fail')
+    s = str(e)
+    assert 'OOS Execution Failed' in s
+    assert 'Execution.Failed' in s
+    assert e.status == 400
+    assert e.code == 'Execution.Failed' 

alibaba_cloud_ops_mcp_server-0.8.9/tests/alibabacloud/test_utils.py

@@ -0,0 +1,15 @@
+from unittest.mock import patch, MagicMock
+from alibaba_cloud_ops_mcp_server.alibabacloud import utils
+
+def test_create_config():
+    with patch('alibaba_cloud_ops_mcp_server.alibabacloud.utils.CredClient') as mock_cred, \
+         patch('alibaba_cloud_ops_mcp_server.alibabacloud.utils.Config') as mock_cfg:
+        cred = MagicMock()
+        mock_cred.return_value = cred
+        cfg = MagicMock()
+        mock_cfg.return_value = cfg
+        result = utils.create_config()
+        assert result is cfg
+        assert cfg.user_agent == 'alibaba-cloud-ops-mcp-server'
+        mock_cred.assert_called_once()
+        mock_cfg.assert_called_once_with(credential=cred) 

alibaba_cloud_ops_mcp_server-0.8.9/tests/test_init.py

@@ -0,0 +1,8 @@
+import pytest
+from unittest.mock import patch, AsyncMock
+import alibaba_cloud_ops_mcp_server
+
+def test_main_calls_server_main():
+    with patch('alibaba_cloud_ops_mcp_server.server.main', new_callable=AsyncMock) as mock_main:
+        alibaba_cloud_ops_mcp_server.main()
+        mock_main.assert_awaited_once()

alibaba_cloud_ops_mcp_server-0.8.9/tests/test_server.py

@@ -0,0 +1,30 @@
+import pytest
+from unittest.mock import patch, MagicMock
+
+@patch('alibaba_cloud_ops_mcp_server.server.FastMCP')
+@patch('alibaba_cloud_ops_mcp_server.server.api_tools.create_api_tools')
+def test_main_run(mock_create_api_tools, mock_FastMCP):
+    with patch('alibaba_cloud_ops_mcp_server.server.oss_tools.tools', [lambda: None]), \
+         patch('alibaba_cloud_ops_mcp_server.server.oos_tools.tools', [lambda: None]), \
+         patch('alibaba_cloud_ops_mcp_server.server.cms_tools.tools', [lambda: None]):
+        from alibaba_cloud_ops_mcp_server import server
+        mcp = MagicMock()
+        mock_FastMCP.return_value = mcp
+        # 调用main函数
+        server.main.callback(transport='stdio', port=12345, host='127.0.0.1')
+        mock_FastMCP.assert_called_once_with(name='alibaba-cloud-ops-mcp-server', port=12345, host='127.0.0.1')
+        assert mcp.add_tool.call_count == 3  # oss/oos/cms 各1
+        mock_create_api_tools.assert_called_once()
+        mcp.run.assert_called_once_with(transport='stdio')
+
+def test_run_as_main(monkeypatch):
+    import runpy, sys
+    from alibaba_cloud_ops_mcp_server import server
+    monkeypatch.setattr(server, 'main', lambda *a, **kw: None)
+    monkeypatch.setattr(sys, 'argv', ['server.py'])
+    import mcp.server.fastmcp
+    monkeypatch.setattr(mcp.server.fastmcp.FastMCP, 'run', lambda self, **kwargs: None)
+    import pytest
+    with pytest.raises(SystemExit) as e:
+        runpy.run_path('src/alibaba_cloud_ops_mcp_server/server.py', run_name='__main__')
+    assert e.value.code == 0