Iac Memory MCP Server

🚀 インフラストラクチャ即コードメモリMCPサーバー

このサーバーは、Claude AIの機能を強化するMCP（モデルコンテキストプロトコル）サーバーです。IaC（インフラストラクチャ即コード）コンポーネントに永続的なメモリストレージを提供することで、バージョン追跡と関係マッピングを実現します。主にTerraformとAnsibleのリソースに焦点を当てています。

⚠️ 重要提示

これは個人プロジェクトであり、AIの能力をテストするために作成されました。作成者（私）が関連する専門知識を欠いている状況を想定しています。コストが高いため、このプロジェクトのさらなる開発やメンテナンスは行う予定はありません。

🚀 クイックスタート

IaC Memory MCP Server は、次の機能を提供することで、正確でバージョンを認識したIaCコンポーネントのコンテキストを維持するという課題を解決します。

• IaCコンポーネントの永続的なストレージとバージョン追跡
• 階層型リソース組織とURIベースのアクセス
• コンポーネント間の包括的な関係マッピング
• バージョン固有のドキュメント管理
• スキーマ検証と時間メタデータ追跡
• 自動化された関係分析と洞察

✨ 主な機能

リソース管理

サーバーは、階層型URIを持つ複雑なリソース管理システムを実装しています。

リソースURI構造

resources://<platform>/<category>/<name>

サポートされるプラットフォーム：

• terraform
• ansible
• iac（汎用インフラストラクチャエンティティ用）

URIの例：

resources://terraform/providers/aws
resources://terraform/resources/aws/s3_bucket
resources://ansible/collections/community.aws
resources://ansible/modules/community.aws/s3_bucket

リソーステンプレート

サーバーは、標準的なアクセスパターンを標準化するための動的なリソーステンプレートを提供します。

• Terraformプロバイダー情報：resources://terraform/providers/{provider_name}
• リソースタイプ詳細：resources://terraform/resources/{provider_name}/{resource_type}
• Ansibleコレクションデータ：resources://ansible/collections/{collection_name}
• モジュール情報：resources://ansible/modules/{collection_name}/{module_name}

プロンプト

サーバーは、IaCコンポーネントの発見と分析に特化した4つのプロンプトを実装しています。

search_resources

• 目的：IaCリソースを検索する
• パラメータ：
  • provider：プロバイダー名
  • resource_type：リソースタイプ
• 出力：指定されたプラットフォームのすべてのリソースのリストを返す

get_resource_schema

• 目的：特定のリソースのスキーマを取得する
• パラメータ：
  • platform：プラットフォーム名（terraformまたはansible）
  • provider：プロバイダー名
  • resource_type：リソースタイプ
• 出力：リソースの詳細なスキーマ情報を返す

validate_resource

• 目的：リソース構成の有効性を検証する
• パラメータ：
  • platform：プラットフォーム名（terraformまたはansible）
  • provider：プロバイダー名
  • resource_type：リソースタイプ
  • schema_version：スキーマバージョン
  • configuration：検証する構成内容
• 出力：検証結果とエラー情報を返す

get_resource_relations

• 目的：リソース間の関係マッピングを取得する
• パラメータ：
  • platform：プラットフォーム名（terraformまたはansible）
  • provider：プロバイダー名
  • resource_type：リソースタイプ
• 出力：他のリソースとの関係のリストを返す

ツール

サーバーは以下のツールを実装しています。

Terraformツール

def get_terraform_provider_schemas():
    pass

def get_terraform_resource_schema(provider: str, resource_type: str) -> dict:
    pass

def validate_terraform_resource(
    provider: str,
    resource_type: str,
    schema_version: str,
    configuration: dict
) -> dict:
    pass

Ansibleツール

def get_ansible_collection_schemas():
    pass

def get_ansible_resource_schema(collection: str, resource_type: str) -> dict:
    pass

def validate_ansible_resource(
    collection: str,
    resource_type: str,
    schema_version: str,
    configuration: dict
) -> dict:
    pass

エンティティ操作ツール

def get_entity_relationships() -> list:
    pass

📦 インストール

サーバーの設定

環境変数を使用してサーバーを設定します。

DATABASE_URL=sqlite:////home/herman/iac.db

Claude Desktopとの統合

開発環境

uv.jsonに以下の内容を追加して開発環境を設定します。

"mcpServers": {
    "iac-memory": {
        "command": "uv sync",
        "args": [],
        "env": {
            "DATABASE_URL": "sqlite:////home/herman/iac.db"
        }
    }
}

本番環境

uv.jsonに以下の内容を追加して本番環境を設定します。

"mcpServers": {
    "iac-memory": {
        "command": "uvx",
        "args": [
            "--from",
            "git+https://github.com/AgentWong/iac-memory-mcp-server.git",
            "python",
            "-m",
            "iac_memory_mcp_server"
        ],
        "env": {
            "DATABASE_URL": "sqlite:////home/herman/iac.db"
        }
    }
}

💻 使用例

ローカル開発

# 依存関係のインストール
uv sync

# テストの実行
uv run pytest

# MCPインスペクターを使用した開発サーバーの起動
npx @modelcontextprotocol/inspector uv run iac-memory-mcp-server

📄 ライセンス

このプロジェクトはMIT Licenseの下で公開されています。詳細はLICENSEファイルを参照してください。