MCP システムオペレーター

Infrastructure as Code 運用のための Model Context Protocol (MCP) サーバー。このサーバーにより、AI アシスタントは Ansible および Terraform と連携し、プレイブックや Terraform プランを実行したり、クラウドリソースを管理したり、その他のインフラストラクチャ操作を直接実行したりできるようになります。
(以前はmcp-ansibleとして知られていたプロジェクト)

デモプロジェクト

デモのすべてのコードは、Claude 3.7 Sonnet (OpenRouter経由)、Cline、およびSysOperatorを使用して生成されています。

AWS LAMP スタック- AWS でサンプル LAMP スタックをデプロイするためのすべての Ansible コード
AWS Terraform LAMP - LAMPスタックに応答するためのTerraformとAnsibleコード

Related MCP server: Ansible MCP Server

特徴

Ansible プレイブックの実行: インベントリ、追加変数、タグ、制限などのパラメータをサポートした Ansible プレイブックを実行します。
インベントリの一覧表示: Ansible インベントリファイルからホストとグループを表示します。
構文チェック: 実行せずにAnsibleプレイブックの構文を検証する
タスクの一覧: プレイブックによって実行されるタスクをプレビューします
デフォルトのインベントリにアクセス: リソース API 経由でデフォルトの Ansible インベントリファイルにアクセスします。
AWS 統合: AWS リソース (EC2、S3、VPC、CloudFormation など) を管理します
Terraform サポート: Terraform コマンド (init、plan、apply、destroy、output など) を実行します。
tflocal 統合: ローカルクラウド開発用の LocalStack で Terraform 構成をテストする
LocalStack サポート: 実際の AWS 認証情報なしで LocalStack を使用して AWS 操作をローカルでテストします

要件

Node.js 18以上
npmまたはyarn
Ansibleがインストールされ、PATHに設定されている
@modelcontextprotocol/sdk (自動的にインストールされます)
AWS オペレーションの場合: AWS CLI と有効な認証情報
LocalStackの場合: LocalStackがインストールされ実行中、awslocal CLI

インストール

1. リポジトリをクローンする

git clone https://github.com/tarnover/mcp-sysoperator.git
cd mcp-sysoperator

2. 依存関係をインストールする

npm install

3. サーバーを構築する

npm run build

4. MCP設定を構成する

Ansible MCP サーバーを MCP 設定構成ファイルに追加します。

Claude 拡張機能付きの VSCode の場合:

~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonにあるファイルを編集します。

Claude デスクトップアプリの場合:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonを編集します。
Windows: %APPDATA%\Claude\claude_desktop_config.jsonを編集します。
Linux: ~/.config/Claude/claude_desktop_config.jsonを編集します。

mcpServersセクションに以下を追加します。

{
  "mcpServers": {
    "sysoperator": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-sysoperator/build/index.js"],
      "env": {}
    }
  }
}

/absolute/path/to/mcp-sysoperator実際のインストールパスに置き換えてください。

使用例

MCP サーバーをインストールして構成すると、AI アシスタントに次のツールが提供されます。

1. プレイブックを実行する

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>run_playbook</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml",
  "inventory": "/path/to/inventory.ini",
  "extraVars": {
    "var1": "value1",
    "var2": "value2"
  },
  "tags": "setup,configure",
  "limit": "webservers"
}
</arguments>
</use_mcp_tool>

2. 在庫リスト

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>list_inventory</tool_name>
<arguments>
{
  "inventory": "/path/to/inventory.ini"
}
</arguments>
</use_mcp_tool>

3. プレイブックの構文を確認する

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>check_syntax</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml"
}
</arguments>
</use_mcp_tool>

4. プレイブックにタスクをリストする

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>list_tasks</tool_name>
<arguments>
{
  "playbook": "/path/to/your/playbook.yml"
}
</arguments>
</use_mcp_tool>

5. デフォルトの在庫リソースにアクセスする

<access_mcp_resource>
<server_name>sysoperator</server_name>
<uri>sysoperator://inventory/default</uri>
</access_mcp_resource>

6. AWS S3 オペレーション

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>aws_s3</tool_name>
<arguments>
{
  "action": "list_buckets",
  "region": "us-east-1"
}
</arguments>
</use_mcp_tool>

7. Terraform の初期化と計画

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>terraform</tool_name>
<arguments>
{
  "action": "init",
  "workingDir": "/path/to/terraform/project"
}
</arguments>
</use_mcp_tool>

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>terraform</tool_name>
<arguments>
{
  "action": "plan",
  "workingDir": "/path/to/terraform/project",
  "vars": {
    "instance_type": "t2.micro",
    "region": "us-west-2"
  }
}
</arguments>
</use_mcp_tool>

8. Terraform 適用

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>terraform</tool_name>
<arguments>
{
  "action": "apply",
  "workingDir": "/path/to/terraform/project",
  "autoApprove": true,
  "vars": {
    "instance_type": "t2.micro",
    "region": "us-west-2"
  }
}
</arguments>
</use_mcp_tool>

9. LocalStack を使用した Terraform (tflocal)

<use_mcp_tool>
<server_name>sysoperator</server_name>
<tool_name>terraform</tool_name>
<arguments>
{
  "action": "apply",
  "workingDir": "/path/to/terraform/project",
  "useLocalstack": true,
  "autoApprove": true,
  "vars": {
    "instance_type": "t2.micro",
    "region": "us-west-2"
  }
}
</arguments>
</use_mcp_tool>

LocalStack統合

このプロジェクトには、実際のAWS認証情報を使用せずにAWSオペレーションをローカルでテストするためのLocalStackとの統合が含まれています。LocalStackとの統合により、以下のことが可能になります。

AWS サービスをローカルで使用する Ansible プレイブックをテストする
AWS コストをかけずに AWS オペレーションを開発およびテストする
実際の AWS 認証情報を必要とせずにテストを実行
実際のAWSにデプロイする前にインフラストラクチャコードを検証する

LocalStackの使用

LocalStack 統合の使用に関する詳細な手順については、 LocalStack README を参照してください。

クイックスタート:

# Install LocalStack and awslocal CLI
pip install localstack awscli-local

# Start LocalStack
localstack start

# Run the sample playbook
node localstack/run_sample_playbook.mjs

発達

プロジェクト構造

mcp-sysoperator/
├── src/
│   ├── index.ts                  # Main entry point
│   └── ansible-mcp-server/       # Will be renamed in filesystem in future updates
│       ├── index.ts              # MCP SysOperator server implementation
│       ├── common/               # Common utilities and types
│       │   ├── errors.ts         # Error definitions
│       │   ├── types.ts          # Type and schema definitions
│       │   ├── utils.ts          # Utility functions
│       │   └── version.ts        # Version information
│       └── operations/           # Operation handlers
│           ├── ad_hoc.ts         # Ansible ad-hoc commands
│           ├── aws.ts            # AWS operations
│           ├── inventory.ts      # Ansible inventory operations
│           ├── playbooks.ts      # Ansible playbook operations
│           ├── terraform.ts      # Terraform operations
│           └── vault.ts          # Ansible vault operations
├── localstack/                   # LocalStack integration
│   ├── README.md                 # LocalStack documentation
│   ├── sample_playbook.yml       # Sample playbook for LocalStack
│   ├── inventory.ini             # Sample inventory for LocalStack
│   ├── run_sample_playbook.mjs   # Script to run sample playbook
│   └── utils.localstack.ts       # Modified utils for LocalStack
├── package.json                  # Project configuration and dependencies
├── tsconfig.json                 # TypeScript configuration
└── README.md                     # Documentation

新機能の追加

MCP サーバーに新しい機能を追加するには:

src/ansible-mcp-server/index.tsを変更します (将来: src/sysoperator/index.ts )
setupToolHandlersメソッドに新しいツールを追加します
適切な操作ファイルにツールのハンドラー関数を実装します。
common/types.tsにスキーマ定義を追加する
npm run buildでリビルドする

⚠️免責事項

SysOperatorは現在開発中であり、広範囲にわたるテストが行われています。現時点では本番環境での使用は推奨されません。ソフトウェアには、互換性を損なう変更、不完全な機能、または予期しない動作が発生する可能性があります。

自己責任でご使用ください。

ライセンス

MITライセンス - 詳細はライセンスを参照

MCP SysOperator