alibaba-cloud-ops-mcp-server 0.9.25__tar.gz → 0.9.27__tar.gz

{alibaba_cloud_ops_mcp_server-0.9.25 → alibaba_cloud_ops_mcp_server-0.9.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alibaba-cloud-ops-mcp-server
-Version: 0.9.25
+Version: 0.9.27
 Summary: A MCP server for Alibaba Cloud
 Author-email: Zheng Dayu <dayu.zdy@alibaba-inc.com>, Zhao Shuaibo <zhaoshuaibo.zsb@alibaba-inc.com>
 License-File: LICENSE
@@ -9,7 +9,10 @@ Requires-Dist: alibabacloud-cms20190101>=3.1.4
 Requires-Dist: alibabacloud-credentials>=1.0.3
 Requires-Dist: alibabacloud-ecs20140526>=6.1.0
 Requires-Dist: alibabacloud-oos20190601>=3.5.0
+Requires-Dist: alibabacloud-openapi-util>=0.2.0
 Requires-Dist: alibabacloud-oss-v2>=1.2.0
+Requires-Dist: alibabacloud-tea-openapi>=0.3.0
+Requires-Dist: alibabacloud-tea-util>=0.3.0
 Requires-Dist: click>=8.1.8
 Requires-Dist: fastmcp==2.8.0
 Requires-Dist: pydantic==2.11.3
@@ -23,6 +26,17 @@ Description-Content-Type: text/markdown
 
 Alibaba Cloud Ops MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that provides seamless integration with Alibaba Cloud APIs, enabling AI assistants to operate resources on Alibaba Cloud, supporting ECS, Cloud Monitor, OOS, OSS, VPC, RDS and other widely used cloud products. It also enables AI assistants to analyze, build, and deploy applications to Alibaba Cloud ECS instances.
 
+## MCP Maketplace Integration
+
+* [Qoder](https://qoder.com) <a href="qoder://aicoding.aicoding-deeplink/mcp/add?name=alibaba-cloud-ops-mcp-server&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMnV2eCUyMiUyQyUyMmFyZ3MlMjIlM0ElNUIlMjJhbGliYWJhLWNsb3VkLW9wcy1tY3Atc2VydmVyJTQwbGF0ZXN0JTIyJTVEJTJDJTIyZW52JTIyJTNBJTdCJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEJTIyJTNBJTIyWW91ciUyMEFjY2VzcyUyMEtleSUyMElkJTIyJTJDJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCUyMiUzQSUyMllvdXIlMjBBY2Nlc3MlMjBLZXklMjBTRUNSRVQlMjIlN0QlN0Q%3D"><img src="./image/qoder.svg" alt="Install MCP Server" height="20"></a>
+* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElkIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTZWNyZXQifX0%3D)
+* [Cline](https://cline.bot/mcp-marketplace)
+* [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)
+
 ## Features
 
 - **ECS Management**: Create, start, stop, reboot, delete instances, run commands, view instances, regions, zones, images, security groups, and more
@@ -70,17 +84,6 @@ To use `alibaba-cloud-ops-mcp-server` MCP Server with any other MCP Client, you
 
 [For detailed parameter description, see MCP startup parameter document](./README_mcp_args.md)
 
-## MCP Maketplace Integration
-
-* [Qoder](https://qoder.com) <a href="qoder://aicoding.aicoding-deeplink/mcp/add?name=alibaba-cloud-ops-mcp-server&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMnV2eCUyMiUyQyUyMmFyZ3MlMjIlM0ElNUIlMjJhbGliYWJhLWNsb3VkLW9wcy1tY3Atc2VydmVyJTQwbGF0ZXN0JTIyJTVEJTJDJTIyZW52JTIyJTNBJTdCJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEJTIyJTNBJTIyWW91ciUyMEFjY2VzcyUyMEtleSUyMElkJTIyJTJDJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCUyMiUzQSUyMllvdXIlMjBBY2Nlc3MlMjBLZXklMjBTRUNSRVQlMjIlN0QlN0Q%3D"><img src="./image/qoder.svg" alt="Install MCP Server" height="20"></a>
-* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElkIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTZWNyZXQifX0%3D)
-* [Cline](https://cline.bot/mcp-marketplace)
-* [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 Ops MCP Server is ready to use out of the box!！](https://developer.aliyun.com/article/1661348)

alibaba_cloud_ops_mcp_server-0.9.27/README_mcp_args.md

@@ -0,0 +1,78 @@
+# MCP Startup Parameters Guide
+
+This document provides a detailed introduction to the available parameters for starting the Alibaba Cloud MCP Server, helping users configure the server according to their needs.
+
+## Parameter Table
+
+|       Parameter             | Required |  Type   |   Default    | Description                                                                                                                                                                                                                                                                                                                                                                                                                           |
+|:---------------------------:|:--------:|:-------:|:------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `--transport`               |    No    | string  |   `stdio`    | Transport protocol for MCP Server communication.<br>Options:<br>&nbsp;&nbsp;&nbsp;&nbsp;• `stdio` <br>&nbsp;&nbsp;&nbsp;&nbsp;• `sse` <br>&nbsp;&nbsp;&nbsp;&nbsp;• `streamable-http`                                                                                                                                                                                                                                                 |
+| `--port`                    |    No    |  int    |   `8000`     | Specifies the port number MCP Server listens on. Make sure the port is not occupied.                                                                                                                                                                                                                                                                                                                                                  |
+| `--host`                    |    No    | string  | `127.0.0.1`  | Specifies the host address MCP Server listens on. `0.0.0.0` means listening on all network interfaces.                                                                                                                                                                                                                                                                                                                                |
+| `--services`                |    No    | string  |    None      | Comma-separated services, e.g., `ecs,vpc`.<br>Supported services:<br>&nbsp;&nbsp;&nbsp;&nbsp;• `ecs`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `oos`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `rds`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `vpc`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `slb`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `ess`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `ros`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `cbn`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `dds`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `r-kvstore`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `bssopenapi` |
+| `--headers-credential-only` |    No    |  bool   |   `false`    | Whether to use credentials only from HTTP headers. When enabled, credentials must be provided via request headers instead of environment variables.                                                                                                                                                                                                                                                                                   |
+| `--env`                     |    No    | string  |  `domestic`  | Environment type for API endpoints.<br>Options:<br>&nbsp;&nbsp;&nbsp;&nbsp;• `domestic` - Use domestic (China) endpoints<br>&nbsp;&nbsp;&nbsp;&nbsp;• `international` - Use international (overseas) endpoints                                                                                                                                                                                                                        |
+| `--code-deploy`             |    No    |  flag   |   `false`    | Enable code deploy mode. When enabled, only loads 6 specific tools:<br>&nbsp;&nbsp;&nbsp;&nbsp;• `OOS_CodeDeploy`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `OOS_GetDeployStatus`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `OOS_GetLastDeploymentInfo`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `LOCAL_ListDirectory`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `LOCAL_RunShellScript`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `LOCAL_AnalyzeDeployStack`                                          |
+| `--extra-config`            |    No    | string  |    None      | Add extra services and APIs to config (additive, does not replace existing config). Supports JSON format or Python dict format with single quotes.<br>Example: `"{'sls': ['GetProject', 'ListProject'], 'ecs': ['StartInstance']}"`                                                                                                                                                                                                  |
+| `--visible-tools`           |    No    | string  |    None      | Comma-separated list of tool names to make visible (whitelist mode). Only these specified tools will be registered when this parameter is provided.<br>Example: `OOS_RunCommand,ECS_DescribeInstances,LOCAL_ListDirectory`                                                                                                                                                                                                            |
+
+## Usage Examples
+
+### Basic Usage
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --transport sse --port 8080 --host 0.0.0.0 --services ecs,vpc
+```
+
+### Code Deploy Mode
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --code-deploy
+```
+
+### Add Extra APIs via MCP Config
+Using `--extra-config` to dynamically add services and APIs:
+
+```bash
+# JSON format (double quotes inside)
+uv run src/alibaba_cloud_ops_mcp_server/server.py --extra-config '{"sls": ["GetProject", "ListProject"], "ecs": ["StartInstance"]}'
+
+# Python dict format (single quotes inside)
+uv run src/alibaba_cloud_ops_mcp_server/server.py --extra-config "{'sls': ['GetProject', 'ListProject'], 'ecs': ['StartInstance']}"
+```
+
+### Whitelist Mode
+Using `--visible-tools` to only expose specific tools:
+
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --visible-tools "OOS_RunCommand,ECS_DescribeInstances,LOCAL_ListDirectory"
+```
+
+### International Environment
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --env international --services ecs,vpc
+```
+
+### MCP JSON Configuration Example
+
+You can configure these parameters in your MCP client's JSON configuration file:
+
+```json
+{
+  "mcpServers": {
+    "alibaba-cloud-ops-mcp-server": {
+      "timeout": 600,
+      "command": "uvx",
+      "args": [
+        "alibaba-cloud-ops-mcp-server@latest"
+      ],
+      "env": {
+        "ALIBABA_CLOUD_ACCESS_KEY_ID": "Your Access Key ID",
+        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "Your Access Key SECRET"
+      }
+    }
+  }
+}
+```
+
+---
+
+For more help, please refer to the main project documentation or contact the maintainer. 

alibaba_cloud_ops_mcp_server-0.9.27/README_mcp_args_zh.md

@@ -0,0 +1,78 @@
+# MCP 启动参数说明
+
+本文档详细介绍 Alibaba Cloud MCP Server 的可用启动参数，帮助用户根据需求配置服务器。
+
+## 参数列表
+
+|          参数               | 是否必需 |  类型   |    默认值    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                           |
+|:---------------------------:|:-------:|:-------:|:------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `--transport`               |    否    | string  |   `stdio`    | MCP Server 通信传输协议。<br>可选值：<br>&nbsp;&nbsp;&nbsp;&nbsp;• `stdio` <br>&nbsp;&nbsp;&nbsp;&nbsp;• `sse` <br>&nbsp;&nbsp;&nbsp;&nbsp;• `streamable-http`                                                                                                                                                                                                                                                                  |
+| `--port`                    |    否    |  int    |   `8000`     | MCP Server 监听的端口号，请确保端口未被占用。                                                                                                                                                                                                                                                                                                                                                                                  |
+| `--host`                    |    否    | string  | `127.0.0.1`  | MCP Server 监听的主机地址。`0.0.0.0` 表示监听所有网络接口。                                                                                                                                                                                                                                                                                                                                                                     |
+| `--services`                |    否    | string  |    None      | 逗号分隔的服务列表，例如 `ecs,vpc`。<br>支持的服务：<br>&nbsp;&nbsp;&nbsp;&nbsp;• `ecs` - 弹性计算服务<br>&nbsp;&nbsp;&nbsp;&nbsp;• `oos` - 运维编排服务<br>&nbsp;&nbsp;&nbsp;&nbsp;• `rds` - 关系型数据库<br>&nbsp;&nbsp;&nbsp;&nbsp;• `vpc` - 专有网络<br>&nbsp;&nbsp;&nbsp;&nbsp;• `slb` - 负载均衡<br>&nbsp;&nbsp;&nbsp;&nbsp;• `ess` - 弹性伸缩<br>&nbsp;&nbsp;&nbsp;&nbsp;• `ros` - 资源编排<br>&nbsp;&nbsp;&nbsp;&nbsp;• `cbn` - 云企业网<br>&nbsp;&nbsp;&nbsp;&nbsp;• `dds` - MongoDB 数据库<br>&nbsp;&nbsp;&nbsp;&nbsp;• `r-kvstore` - Tair (兼容 Redis)<br>&nbsp;&nbsp;&nbsp;&nbsp;• `bssopenapi` - 费用中心 |
+| `--headers-credential-only` |    否    |  bool   |   `false`    | 是否仅使用 HTTP 请求头中的凭证。启用后，凭证必须通过请求头提供，而非环境变量。                                                                                                                                                                                                                                                                                                                                                   |
+| `--env`                     |    否    | string  |  `domestic`  | API 端点的环境类型。<br>可选值：<br>&nbsp;&nbsp;&nbsp;&nbsp;• `domestic` - 使用国内端点<br>&nbsp;&nbsp;&nbsp;&nbsp;• `international` - 使用国际端点                                                                                                                                                                                                                                                                              |
+| `--code-deploy`             |    否    |  flag   |   `false`    | 启用代码部署模式。启用后，仅加载以下 6 个工具：<br>&nbsp;&nbsp;&nbsp;&nbsp;• `OOS_CodeDeploy`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `OOS_GetDeployStatus`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `OOS_GetLastDeploymentInfo`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `LOCAL_ListDirectory`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `LOCAL_RunShellScript`<br>&nbsp;&nbsp;&nbsp;&nbsp;• `LOCAL_AnalyzeDeployStack`                                                         |
+| `--extra-config`            |    否    | string  |    None      | 动态添加额外的服务和 API（累加模式，不会替换现有配置）。支持 JSON 格式或 Python 字典格式（单引号）。<br>示例：`"{'sls': ['GetProject', 'ListProject'], 'ecs': ['StartInstance']}"`                                                                                                                                                                                                                                               |
+| `--visible-tools`           |    否    | string  |    None      | 工具白名单模式。逗号分隔的工具名称列表，仅注册指定的工具。<br>示例：`OOS_RunCommand,ECS_DescribeInstances,LOCAL_ListDirectory`                                                                                                                                                                                                                                                                                                   |
+
+## 使用示例
+
+### 基本用法
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --transport sse --port 8080 --host 0.0.0.0 --services ecs,vpc
+```
+
+### 代码部署模式
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --code-deploy
+```
+
+### 通过 MCP 配置动态添加 API
+使用 `--extra-config` 动态添加服务和 API：
+
+```bash
+# JSON 格式（内部使用双引号）
+uv run src/alibaba_cloud_ops_mcp_server/server.py --extra-config '{"sls": ["GetProject", "ListProject"], "ecs": ["StartInstance"]}'
+
+# Python 字典格式（内部使用单引号）
+uv run src/alibaba_cloud_ops_mcp_server/server.py --extra-config "{'sls': ['GetProject', 'ListProject'], 'ecs': ['StartInstance']}"
+```
+
+### 白名单模式
+使用 `--visible-tools` 仅暴露指定的工具：
+
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --visible-tools "OOS_RunCommand,ECS_DescribeInstances,LOCAL_ListDirectory"
+```
+
+### 国际环境
+```bash
+uv run src/alibaba_cloud_ops_mcp_server/server.py --env international --services ecs,vpc
+```
+
+### MCP JSON 配置示例
+
+您可以在 MCP 客户端的 JSON 配置文件中设置这些参数：
+
+```json
+{
+  "mcpServers": {
+    "alibaba-cloud-ops-mcp-server": {
+      "timeout": 600,
+      "command": "uvx",
+      "args": [
+        "alibaba-cloud-ops-mcp-server@latest"
+      ],
+      "env": {
+        "ALIBABA_CLOUD_ACCESS_KEY_ID": "Your Access Key ID",
+        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "Your Access Key SECRET"
+      }
+    }
+  }
+}
+```
+
+---
+
+如需更多帮助，请参考项目主文档或联系维护者。

{alibaba_cloud_ops_mcp_server-0.9.25 → alibaba_cloud_ops_mcp_server-0.9.27}/README_zh.md

@@ -6,6 +6,17 @@
 
 Alibaba Cloud Ops MCP Server是一个[模型上下文协议（MCP）](https://modelcontextprotocol.io/introduction)服务器，提供与阿里云API的无缝集成，使AI助手能够操作阿里云上的资源，支持ECS、云监控、OOS、OSS、VPC、RDS等广泛使用的云产品。同时，它还使AI助手能够分析、构建和部署应用到阿里云ECS实例。
 
+## MCP市场集成
+
+* [Qoder](https://qoder.com) <a href="qoder://aicoding.aicoding-deeplink/mcp/add?name=alibaba-cloud-ops-mcp-server&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMnV2eCUyMiUyQyUyMmFyZ3MlMjIlM0ElNUIlMjJhbGliYWJhLWNsb3VkLW9wcy1tY3Atc2VydmVyJTQwbGF0ZXN0JTIyJTVEJTJDJTIyZW52JTIyJTNBJTdCJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEJTIyJTNBJTIyWW91ciUyMEFjY2VzcyUyMEtleSUyMElkJTIyJTJDJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCUyMiUzQSUyMllvdXIlMjBBY2Nlc3MlMjBLZXklMjBTRUNSRVQlMjIlN0QlN0Q%3D"><img src="./image/qoder.svg" alt="Install MCP Server" height="20"></a>
+* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElkIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTZWNyZXQifX0%3D)
+* [Cline](https://cline.bot/mcp-marketplace)
+* [魔搭](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)
+
 ## 功能特性
 
 - **ECS 管理**：创建、启动、停止、重启、删除实例，运行命令，查看实例、地域、可用区、镜像、安全组等
@@ -51,18 +62,7 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 }
 ```
 
-[详细参数说明见 MCP 启动参数文档](./README_mcp_args.md)
-
-## MCP市场集成
-
-* [Qoder](https://qoder.com) <a href="qoder://aicoding.aicoding-deeplink/mcp/add?name=alibaba-cloud-ops-mcp-server&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMnV2eCUyMiUyQyUyMmFyZ3MlMjIlM0ElNUIlMjJhbGliYWJhLWNsb3VkLW9wcy1tY3Atc2VydmVyJTQwbGF0ZXN0JTIyJTVEJTJDJTIyZW52JTIyJTNBJTdCJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEJTIyJTNBJTIyWW91ciUyMEFjY2VzcyUyMEtleSUyMElkJTIyJTJDJTIyQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCUyMiUzQSUyMllvdXIlMjBBY2Nlc3MlMjBLZXklMjBTRUNSRVQlMjIlN0QlN0Q%3D"><img src="./image/qoder.svg" alt="Install MCP Server" height="20"></a>
-* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElkIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTZWNyZXQifX0%3D)
-* [Cline](https://cline.bot/mcp-marketplace)
-* [魔搭](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 启动参数文档](./README_mcp_args_zh.md)
 
 ## 了解更多
 

{alibaba_cloud_ops_mcp_server-0.9.25 → alibaba_cloud_ops_mcp_server-0.9.27}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "alibaba-cloud-ops-mcp-server"
-version = "0.9.25"
+version = "0.9.27"
 description = "A MCP server for Alibaba Cloud"
 readme = "README.md"
 authors = [
@@ -14,6 +14,9 @@ dependencies = [
     "alibabacloud-oos20190601>=3.5.0",
     "alibabacloud_oss_v2>=1.2.0",
     "alibabacloud-credentials>=1.0.3",
+    "alibabacloud-openapi-util>=0.2.0",
+    "alibabacloud-tea-openapi>=0.3.0",
+    "alibabacloud-tea-util>=0.3.0",
     "click>=8.1.8",
     "fastmcp==2.8.0",
     "pydantic==2.11.3"

{alibaba_cloud_ops_mcp_server-0.9.25 → alibaba_cloud_ops_mcp_server-0.9.27}/src/alibaba_cloud_ops_mcp_server/server.py

@@ -1,4 +1,7 @@
 import sys
+import copy
+import json
+import ast
 
 from fastmcp import FastMCP
 import click
@@ -43,6 +46,97 @@ SUPPORTED_SERVICES_MAP = {
 }
 
 
+def _register_tools_with_filter(mcp: FastMCP, visible_tools_set: set, visible_tools_original: dict, services: str, extra_config: str):
+    """
+    Register tools based on visible_tools whitelist (case-insensitive).
+    
+    Args:
+        mcp: FastMCP instance
+        visible_tools_set: Set of allowed tool names (lowercase for case-insensitive matching)
+        visible_tools_original: Dict mapping lowercase names to original names
+        services: Services parameter for common_api_tools
+        extra_config: Extra config parameter
+    """
+    registered_tools = set()
+    
+    # 1. Register common_api_tools if services is specified
+    if services:
+        service_keys = [s.strip().lower() for s in services.split(",")]
+        service_list = [(key, SUPPORTED_SERVICES_MAP.get(key, key)) for key in service_keys]
+        set_custom_service_list(service_list)
+        for tool in common_api_tools.tools:
+            if tool.__name__.lower() in visible_tools_set:
+                mcp.tool(tool)
+                registered_tools.add(tool.__name__.lower())
+    
+    # 2. Register static tools from all modules
+    static_tool_modules = [
+        oos_tools,
+        application_management_tools,
+        cms_tools,
+        oss_tools,
+        local_tools
+    ]
+    
+    for tool_module in static_tool_modules:
+        for tool in tool_module.tools:
+            if tool.__name__.lower() in visible_tools_set:
+                mcp.tool(tool)
+                registered_tools.add(tool.__name__.lower())
+    
+    # 3. Handle dynamic API tools
+    # Parse tool names in visible_tools that follow SERVICE_API format
+    # Use original names to preserve API case (important for Alibaba Cloud APIs)
+    dynamic_tools_config = {}
+    
+    for tool_name_lower in visible_tools_set:
+        if '_' in tool_name_lower and tool_name_lower not in registered_tools:
+            # Get original name to preserve API case
+            original_name = visible_tools_original.get(tool_name_lower, tool_name_lower)
+            parts = original_name.split('_', 1)
+            if len(parts) == 2:
+                service_code = parts[0].lower()
+                api_name = parts[1]  # Preserve original case
+                if service_code not in dynamic_tools_config:
+                    dynamic_tools_config[service_code] = []
+                if api_name not in dynamic_tools_config[service_code]:
+                    dynamic_tools_config[service_code].append(api_name)
+    
+    # 4. Merge with extra_config (only tools in visible_tools whitelist)
+    if extra_config:
+        try:
+            try:
+                extra = json.loads(extra_config)
+            except json.JSONDecodeError:
+                extra = ast.literal_eval(extra_config)
+            
+            for service_code, apis in extra.items():
+                for api in apis:
+                    tool_name_lower = f"{service_code.lower()}_{api.lower()}"
+                    if tool_name_lower in visible_tools_set:
+                        if service_code not in dynamic_tools_config:
+                            dynamic_tools_config[service_code] = []
+                        if api not in dynamic_tools_config[service_code]:
+                            dynamic_tools_config[service_code].append(api)
+            logger.info(f'Merged extra config with visible tools filter: {dynamic_tools_config}')
+        except Exception as e:
+            logger.error(f'Failed to parse extra-config: {e}')
+    
+    # 5. Create dynamic API tools
+    if dynamic_tools_config:
+        api_tools.create_api_tools(mcp, dynamic_tools_config)
+        for service_code, apis in dynamic_tools_config.items():
+            for api in apis:
+                registered_tools.add(f"{service_code.lower()}_{api.lower()}")
+    
+    # 6. Log results
+    unregistered_tools = visible_tools_set - registered_tools
+    if unregistered_tools:
+        logger.warning(f"The following tools were not found and not registered: {unregistered_tools}")
+    
+    logger.info(f"Visible tools mode: registered {len(registered_tools)} tools: {registered_tools}")
+
+
 @click.command()
 @click.option(
     "--transport",
@@ -86,7 +180,19 @@ SUPPORTED_SERVICES_MAP = {
     default=False,
     help="Enable code deploy mode, only load 6 specific tools: OOS_CodeDeploy, OOS_GetDeployStatus, OOS_GetLastDeploymentInfo, LOCAL_ListDirectory, LOCAL_RunShellScript, LOCAL_AnalyzeDeployStack",
 )
-def main(transport: str, port: int, host: str, services: str, headers_credential_only: bool, env: str, code_deploy: bool):
+@click.option(
+    "--extra-config",
+    type=str,
+    default=None,
+    help="Add extra services and APIs to config, e.g., \"{'sls': ['GetProject', 'ListProject'], 'ecs': ['StartInstance']}\"",
+)
+@click.option(
+    "--visible-tools",
+    type=str,
+    default=None,
+    help="Comma-separated list of tool names to make visible (whitelist mode). Only these tools will be registered when specified, e.g., 'OOS_RunCommand,ECS_DescribeInstances,LOCAL_ListDirectory'",
+)
+def main(transport: str, port: int, host: str, services: str, headers_credential_only: bool, env: str, code_deploy: bool, extra_config: str, visible_tools: str):
     _setup_logging()
     # Create an MCP server
     mcp = FastMCP(
@@ -158,6 +264,12 @@ def main(transport: str, port: int, host: str, services: str, headers_credential
         settings.headers_credential_only = headers_credential_only
     if env:
         settings.env = env
+    
+    # Handle mutual exclusivity between code_deploy and visible_tools
+    if code_deploy and visible_tools:
+        logger.warning("--code-deploy and --visible-tools are mutually exclusive. Using --code-deploy mode.")
+        visible_tools = None
+    
     if code_deploy:
         # Code deploy mode: only load 6 specific tools
         code_deploy_tools = {
@@ -179,7 +291,21 @@ def main(transport: str, port: int, host: str, services: str, headers_credential
         for tool in local_tools.tools:
             if tool.__name__ in code_deploy_tools:
                 mcp.tool(tool)
-    else:
+    elif visible_tools:
+        # Visible tools mode: only load tools in whitelist (case-insensitive)
+        # Build both lowercase set and original name mapping
+        visible_tools_list = [tool.strip() for tool in visible_tools.split(",") if tool.strip()]
+        visible_tools_set = set(t.lower() for t in visible_tools_list)
+        visible_tools_original = {t.lower(): t for t in visible_tools_list}
+        if visible_tools_set:
+            logger.info(f"Visible tools mode enabled (case-insensitive). Allowed tools: {visible_tools_set}")
+            _register_tools_with_filter(mcp, visible_tools_set, visible_tools_original, services, extra_config)
+        else:
+            logger.warning("--visible-tools is empty, falling back to normal mode.")
+            # Fall through to normal mode by setting a flag
+            visible_tools = None
+    
+    if not code_deploy and not visible_tools:
         # Normal mode: load all tools
         if services:
             service_keys = [s.strip().lower() for s in services.split(",")]
@@ -197,7 +323,29 @@ def main(transport: str, port: int, host: str, services: str, headers_credential
             mcp.tool(tool)
         for tool in oss_tools.tools:
             mcp.tool(tool)
-        api_tools.create_api_tools(mcp, config)
+        # Merge extra_config into the existing config
+        merged_config = copy.deepcopy(config)
+        if extra_config:
+            try:
+                # Try JSON first, then fallback to ast.literal_eval for single quotes
+                try:
+                    extra = json.loads(extra_config)
+                except json.JSONDecodeError:
+                    extra = ast.literal_eval(extra_config)
+                for service_code, apis in extra.items():
+                    if service_code in merged_config:
+                        # Add new APIs to existing service (avoid duplicates)
+                        existing_apis = set(merged_config[service_code])
+                        for api in apis:
+                            if api not in existing_apis:
+                                merged_config[service_code].append(api)
+                    else:
+                        # Add new service with its APIs
+                        merged_config[service_code] = apis
+                logger.info(f'Merged extra config: {extra}')
+            except Exception as e:
+                logger.error(f'Failed to parse extra-config: {e}')
+        api_tools.create_api_tools(mcp, merged_config)
         for tool in local_tools.tools:
             mcp.tool(tool)