Iac Memory MCP Server Project

🚀 メモリベースのIaC MCPサーバー

このサーバーはClaude AIの機能を強化する記憶型MCPサーバーで、Infrastructure-as-Code (IaC)コンポーネントに永続的なストレージを提供することで、バージョン追跡と関係マッピングを実現し、特にTerraformとAnsibleのリソースに焦点を当てています。

⚠️ 重要提示

これは個人プロジェクトで、AIの能力をテストするために作成されました。ただし、この技術を使用する私自身は関連する専門知識が不足しています。コストが高いため、このプロジェクトのさらなる開発やメンテナンスは行わない予定です。

🚀 クイックスタート

このサーバーは、正確でバージョンを認識したIaCコンポーネントのコンテキストを維持する問題を解決します。以下の機能を通じて、IaCコンポーネントの管理を効率化します。

✨ 主な機能

• 持続的なストレージとバージョン追跡を提供し、IaCコンポーネントの変更履歴を管理します。
• 階層構造によるリソースの組織化とURIベースのアクセスを実現し、リソースの管理と取得を容易にします。
• コンポーネント間の関係を全面的にマッピングし、依存関係を可視化します。
• バージョン固有のドキュメントを管理し、最新の情報を提供します。
• スキーマ検証とタイムスタンプのメタデータ追跡を行い、データの整合性を保証します。
• 関係の自動分析と洞察の提供により、リソースの最適化を支援します。

🔧 技術詳細

リソース管理

サーバーは複雑なリソース管理システムを実装しており、階層構造化されたURIを採用しています。

リソースURI構造

resources://<プラットフォーム>/<カテゴリ>/<名前>

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

• 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: リソースタイプ
• 戻り値：指定されたプロバイダの特定のリソース情報

analyze_entity

• 目的：エンティティとその関係を分析する
• パラメータ：
  • entity_id: エンティティID
  • include_relationships: 関係を含めるかどうか
• 戻り値：名前、タイプ、観察結果を含む詳細なエンティティ分析

terraform_provider

• 目的：Terraformプロバイダの情報を取得する
• パラメータ：
  • provider_name: プロバイダ名（必須）
  • version: バージョン番号（オプション、デフォルトは最新バージョン）
• 戻り値：指定されたプロバイダのリソーススキーマ

ansible_collection

• 目的：Ansibleコレクションの情報を取得する
• パラメータ：
  • collection_name: コレクション名（必須）
  • version: バージョン番号（オプション、デフォルトは最新バージョン）
• 戻り値：指定されたコレクションのリソーススキーマ

ツール

サーバーは以下の機能を提供します。

• バージョン管理：異なるバージョンのIaCコンポーネントをサポートします。
• 関係マッピング：リソース間の依存関係を分析し、記録します。
• ドキュメント管理：リソースに関連するドキュメントを生成し、管理します。
• スキーマ検証：リソースが事前定義されたスキーマに準拠していることを検証します。
• メタデータ追跡：リソースの作成と変更のタイムスタンプを記録します。

📦 インストール

環境変数

サーバーを構成するには、以下の環境変数を設定します。

# データベースURL、SQLite、MySQL、PostgreSQLなどをサポート
export DATABASE_URL="sqlite:////path/to/database.db"

# デフォルトのバージョン番号（オプション）
export DEFAULT_VERSION="1.0.0"

# ログレベル（オプション：debug, info, warning, error, critical）
export LOG_LEVEL="info"

Claude Desktop開発環境

config.jsonに以下の内容を追加して、MCPサーバーを構成します。

"mcpServers": {
  "iac-memory": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/iac-memory-mcp-server",
      "run",
      "iac-memory-mcp-server"
    ],
    "env": {
          "DATABASE_URL": "sqlite:////home/user/iac.db"
      }
  }
}

Claude Desktop本番環境

config.jsonに以下の内容を追加して、MCPサーバーを構成します。

"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/user/iac.db"
      }
  }
}

💻 使用例

ローカル開発

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

# テストの実行
uv run pytest

# MCP Inspectorを使用したデバッグ
npx @modelcontextprotocol/inspector uv run iac-memory-mcp-server

📄 ライセンス

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