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 組件發現和分析的提示：

• 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 文件。

⚠️ 重要提示

這是一個個人項目，旨在測試 AI 在使用者缺乏相關專業知識時的能力狀態。由於成本過高，不會進一步開發或維護該項目。