Agentwong Iac Memory MCP Server Project

🚀 IaC 內存 MCP 服務器

這是一個增強Claude AI能力的模型上下文協議（MCP）服務器，主要為基礎設施即代碼（IaC）組件提供持久內存存儲。它著重於版本跟蹤和資源關係映射，並且支持Terraform和Ansible資源。

🚀 快速開始

這是一個個人項目，旨在測試在缺乏主題專業知識（尤其是Python知識）的情況下AI的能力。由於成本過高，作者無意進一步開發或維護該項目。

✨ 主要特性

IaC 內存 MCP 服務器通過提供以下功能解決維護準確、版本感知的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}

提示

服務器支持以下提示：

• 創建新會話

/mcp/v1/generate

• 上傳文件

/mcp/v1/upload

工具

MCP 終端機

用於與 MCP 服務器交互的 CLI 工具。 安裝：

pip install mcp-terminal
mcp-terminal iac-memory-mcp-server

MCP 監視器

用於監控和調試 MCP 服務器。 訪問地址：http://localhost:9001

配置

環境變量

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

• DATABASE_URL：數據庫連接字符串（默認為 SQLite）
• DEFAULT_KEY_SIZE：默認密鑰大小
• DEFAULT_IV_SIZE：默認初始化向量大小
• DISABLE_ENCRYPTION：是否禁用加密
• ENCRYPTION_SECRET：加密密鑰

開發

本地開發

• 安裝依賴項

uv sync

• 運行測試

uv run pytest

• 開發服務器與 MCP 監視器

npx @modelcontextprotocol/inspector uv run iac-memory-mcp-server

📄 許可證

本項目 licensed under the MIT License - 請查看 LICENSE 文件以獲取詳細信息。