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 文件以获取详细信息。