Iac Memory MCP Server Project

🚀 基於內存的IaC MCP服務器

這是一個增強Claude AI功能的記憶型MCP服務器，通過為Infrastructure-as-Code (IaC)組件提供持久存儲，實現版本跟蹤和關係映射，尤其專注於Terraform和Ansible資源。

🚀 快速開始

本項目是一個個人項目，用於測試AI能力，前提是使用該技術的人（我）缺乏相關專業知識。由於成本過高，不打算進一步開發或維護該項目。

✨ 主要特性

IaC記憶MCP服務器通過以下方式解決維護準確、版本感知的IaC組件上下文的問題：

• 為IaC組件提供持久存儲和版本跟蹤。
• 提供層次結構化的資源組織與基於URI的訪問。
• 實現組件之間的全面關係映射。
• 管理版本特定的文檔。
• 進行模式驗證和時間戳元數據跟蹤。
• 自動化分析關係並提供見解。

📦 安裝指南

本地開發

# 安裝依賴
uv sync

# 運行測試
uv run pytest

# 使用MCP Inspector進行調試
npx @modelcontextprotocol/inspector uv run iac-memory-mcp-server

💻 使用示例

基礎用法

資源管理

服務器實現了一個複雜的資源管理系統，採用層次結構化的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組件發現和分析：

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: 版本號（可選，默認為最新版本）
• 返回：指定集合的資源模式

📚 詳細文檔

配置

環境變量

設置以下環境變量以配置服務器：

# 數據庫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"
      }
  }
}

📄 許可證

該項目採用MIT許可證，詳情請參閱LICENSE文件。

⚠️ 重要提示

這是一個個人項目，用於測試AI能力，前提是使用該技術的人（我）缺乏相關專業知識。由於成本過高，不打算進一步開發或維護該項目。