Alicloud-ops-mcp：複数の阿里云サービス管理をサポート、Amazon Q CLI用MCP統合ツール

たんさく

Alicloud Ops MCP

クラウドプラットフォーム開発者ツール .Python

スコア : 2ポイント

ダウンロード数 : 6.6K

更新時間 : 2025-07-31

サイトを開く

インストール

以下のコマンドをクライアントにコピーして設定

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 30000,
      "command": "uv",
      "args": [
        "--directory",
        "/绝对路径/to/alicloud-ops-mcp",
        "run",
        "python",
        "complete_fastmcp_server.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 30000,
      "command": "uv",
      "args": [
        "--directory",
        "/home/user/alicloud-ops-mcp",
        "run",
        "python",
        "complete_fastmcp_server.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意：あなたのキーは機密情報です。誰とも共有しないでください。

🚀 アリババクラウドオペレーションMCPサーバー

このサーバーは、Amazon Q CLI用のアリババクラウドオペレーションMCPサーバーです。ECS、VPC、RDS、OSS、CloudMonitor、OOSなどのサービスをサポートしています。

English | 中文

🚀 クイックスタート

システム要件

Python 3.10+ (uvによって自動管理されます)
uv - Pythonパッケージとプロジェクトマネージャー
アリババクラウドアクセス資格情報

手順

1. uvのインストール

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# またはpipを使用する場合
pip install uv

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. プロジェクトのクローン

git clone https://github.com/your-username/alicloud-ops-mcp.git
cd alicloud-ops-mcp

3. 一括インストール

# インストールスクリプトを実行する（推奨）
./install.sh

# または手動でインストールする場合
uv sync
cp .env.example .env
# .envファイルを編集し、あなたのアリババクラウド資格情報を入力します

4. 環境変数の設定

.envファイルを編集します：

ALIBABA_CLOUD_ACCESS_KEY_ID="your_access_key_id"
ALIBABA_CLOUD_ACCESS_KEY_SECRET="your_access_key_secret"
ALIBABA_CLOUD_REGION="cn-beijing"

5. インストールの検証

# 検証スクリプトを実行する
uv run python verify_setup.py

# サーバーの起動をテストする
uv run python complete_fastmcp_server.py

"Server is ready to accept connections." と表示されれば、インストールは成功です。

✨ 主な機能

Amazon Q CLIの設定

~/.aws/amazonq/mcp.jsonに以下の設定を追加します：

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 30000,
      "command": "uv",
      "args": [
        "--directory",
        "/絶対パス/to/alicloud-ops-mcp",
        "run",
        "python",
        "complete_fastmcp_server.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

⚠️ 重要提示

/絶対パス/to/alicloud-ops-mcp をプロジェクトの実際の絶対パスに置き換えてください。

設定例

プロジェクトが /home/user/alicloud-ops-mcp にあると仮定します：

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 30000,
      "command": "uv",
      "args": [
        "--directory",
        "/home/user/alicloud-ops-mcp",
        "run",
        "python",
        "complete_fastmcp_server.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

サポートされるサービス

サービス	機能	状態
ECS	クラウドサーバー管理、インスタンス操作、イメージ管理	✅
VPC	仮想プライベートクラウド、ネットワーク設定、セキュリティグループ	✅
RDS	リレーショナルデータベース管理、バックアップと復元	✅
OSS	オブジェクトストレージ、ファイルのアップロードとダウンロード	✅
CloudMonitor	クラウドモニタリング、アラート管理、指標クエリ	✅
OOS	運用オーケストレーション、自動化タスク	✅

📚 ドキュメント

開発に関する説明

プロジェクト構造

alicloud-ops-mcp/
├── pyproject.toml              # プロジェクト設定と依存関係
├── requirements.txt            # 依存関係リスト（互換性）
├── complete_fastmcp_server.py  # メインサーバーファイル
├── alibaba_cloud_ops_mcp_server/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py              # サーバーの核心ロジック
│   ├── config.py              # 設定管理
│   └── tools/                 # 各サービスのツール
│       ├── __init__.py
│       ├── api_tools.py       # 汎用APIツール
│       ├── cms_tools.py       # CloudMonitorツール
│       ├── common_api_tools.py # 共通APIツール
│       ├── oos_tools.py       # OOSツール
│       └── oss_tools.py       # OSSツール
├── .env.example               # 環境変数のテンプレート
├── .env                       # 環境変数（作成が必要）
├── install.sh                 # インストールスクリプト
├── verify_setup.py            # 検証スクリプト
├── README.md                  # 日本語ドキュメント
├── README_EN.md               # 英語ドキュメント
└── LICENSE

uvを使用した開発

# 開発用の依存関係をインストールする
uv sync --dev

# テストを実行する
uv run pytest

# サーバーを実行する
uv run python complete_fastmcp_server.py

# 新しい依存関係を追加する
uv add package-name

# 開発用の依存関係を追加する
uv add --dev package-name

# 依存関係を更新する
uv sync --upgrade

# 依存関係ツリーを表示する
uv tree

Pythonバージョン管理

プロジェクトは pyproject.toml でPythonバージョンの要件を指定しています：

requires-python = ">=3.10"

uvは自動的に以下のことを行います：

適切なPythonバージョンを検出してインストールする
隔離された仮想環境を作成する
すべての依存関係を管理する
クロスプラットフォームの互換性を確保する

トラブルシューティング

一般的な問題と解決策

1. Permission denied (os error 13)

原因： 設定エラーまたは権限問題 解決策：

# uvコマンドを使用していることを確認する
uv run python complete_fastmcp_server.py

# プロジェクトのパスが正しいことを確認する
pwd

# スクリプトに実行権限があることを確認する
chmod +x complete_fastmcp_server.py

2. Pythonバージョンの互換性問題

エラーメッセージ： Could not find a version that satisfies the requirement fastmcp>=2.8.0 解決策：

# uvが自動的にPythonバージョンを処理するので、手動でインストールする必要はありません
uv sync

# 問題が解決しない場合は、キャッシュをクリアして再インストールする
uv clean
uv sync

3. 依存関係のインストール失敗

解決策：

# キャッシュをクリアして再インストールする
uv clean
uv sync

# 詳細なエラー情報を表示する
uv sync --verbose

4. 環境変数が読み込まれない

解決策：

# .envファイルが存在し、形式が正しいことを確認する
ls -la .env
cat .env

# 環境変数の形式を確認する
uv run python -c "
import os
from dotenv import load_dotenv
load_dotenv()
print('Access Key ID:', os.getenv('ALIBABA_CLOUD_ACCESS_KEY_ID', 'Not found'))
print('Region:', os.getenv('ALIBABA_CLOUD_REGION', 'Not found'))
"

5. MCPサーバーが起動しない

解決策：

# Amazon Q CLIの設定を確認する
cat ~/.aws/amazonq/mcp.json

# パスが正しいことを確認する
ls -la /絶対パス/to/alicloud-ops-mcp/complete_fastmcp_server.py

# サーバーを直接起動してテストする
cd /絶対パス/to/alicloud-ops-mcp
uv run python complete_fastmcp_server.py

デバッグモード

詳細なログを有効にする：

# 環境変数を設定してデバッグを有効にする
export FASTMCP_LOG_LEVEL=DEBUG
uv run python complete_fastmcp_server.py

# または.envファイルに設定する
echo "FASTMCP_LOG_LEVEL=DEBUG" >> .env

設定の検証

完全な環境チェックを実行する：

# 検証スクリプトを実行する
uv run python verify_setup.py

# 特定のコンポーネントを確認する
uv run python -c "
import sys
print(f'Python version: {sys.version}')

try:
    import fastmcp
    print(f'FastMCP version: {fastmcp.__version__}')
except ImportError as e:
    print(f'FastMCP import error: {e}')

try:
    from alibaba_cloud_ops_mcp_server import server
    print('Server module loaded successfully')
except ImportError as e:
    print(f'Server module error: {e}')
"

パフォーマンス最適化

起動の最適化

# Pythonバイトコードを事前コンパイルする
uv run python -m compileall .

# より高速な起動オプションを使用する
uv run python -O complete_fastmcp_server.py

メモリの最適化

.envファイルに以下を追加します：

# メモリ使用量を制限する
PYTHONHASHSEED=0
PYTHONDONTWRITEBYTECODE=1

コントリビューションガイド

プロジェクトをForkする
機能ブランチを作成する (git checkout -b feature/amazing-feature)
開発用の依存関係をインストールする (uv sync --dev)
テストを実行する (uv run pytest)
変更をコミットする (git commit -m 'Add some amazing feature')
ブランチにプッシュする (git push origin feature/amazing-feature)
Pull Requestを作成する

開発環境の設定

# リポジトリをクローンする
git clone https://github.com/your-username/alicloud-ops-mcp.git
cd alicloud-ops-mcp

# 開発用の依存関係をインストールする
uv sync --dev

# pre-commit hooksを設定する
uv run pre-commit install

# テストを実行する
uv run pytest

# コードを整形する
uv run black .
uv run isort .

# 型チェックを実行する
uv run mypy .