MCP cover image
AgentWong_iac-memory-mcp-server-project logo
Public

AgentWong_iac-memory-mcp-server-project

See in Github
2025-01-27

Mirror ofhttps://github.com/AgentWong/iac-memory-mcp-server-project

0

Github Watches

1

Github Forks

0

Github Stars

IaC Memory MCP Server

A Model Context Protocol (MCP) server that enhances Claude AI's capabilities by providing persistent memory storage for Infrastructure-as-Code (IaC) components, with a focus on version tracking and relationship mapping for Terraform and Ansible resources.

[!NOTE]
This was a personal project to determine the state of AI's ability if the person using it (me) doesn't have subject matter expertise (lack of Python knowledge). Since it has become rather cost prohibitive, I do not intend to develop or maintain this project further.

Overview

The IaC Memory MCP Server addresses the challenge of maintaining accurate, version-aware context for IaC components by providing:

  • Persistent storage and version tracking for IaC components
  • Hierarchical resource organization with URI-based access
  • Comprehensive relationship mapping between components
  • Version-specific documentation management
  • Schema validation and temporal metadata tracking
  • Automated relationship analysis and insights

Core Components

Resource Management

The server implements a sophisticated resource management system with hierarchical URIs:

Resource URI Structure

resources://<platform>/<category>/<name>

Supported platforms:

  • terraform
  • ansible
  • iac (for general infrastructure entities)

Example URIs:

resources://terraform/providers/aws
resources://terraform/resources/aws/s3_bucket
resources://ansible/collections/community.aws
resources://ansible/modules/community.aws/s3_bucket

Resource Templates

The server provides dynamic resource templates for standardized access patterns:

  • Terraform provider information: resources://terraform/providers/{provider_name}
  • Resource type details: resources://terraform/resources/{provider_name}/{resource_type}
  • Ansible collection data: resources://ansible/collections/{collection_name}
  • Module information: resources://ansible/modules/{collection_name}/{module_name}

Prompts

The server implements four specialized prompts for IaC component discovery and analysis:

search_resources

  • Purpose: Search for IaC resources
  • Arguments:
    • provider: Provider name
    • resource_type: Resource type
  • Returns: Information about specific resources for the given provider

analyze_entity

  • Purpose: Analyze an entity and its relationships
  • Arguments:
    • entity_id: Entity ID
    • include_relationships: Include relationships
  • Returns: Detailed entity analysis including name, type, and observations

terraform_provider

  • Purpose: Get information about a Terraform provider
  • Arguments:
    • provider_name: Name of the Terraform provider (required)
    • version: Specific version to query (optional)
  • Returns: Detailed provider information for the specified version

ansible_module

  • Purpose: Get information about an Ansible module
  • Arguments:
    • collection_name: Name of the Ansible collection (required)
    • module_name: Name of the module (required)
    • version: Specific version to query (optional)
  • Returns: Detailed module information for the specified version

Tools

The server implements comprehensive tooling for IaC component management:

Terraform Tools

  • get_terraform_provider_info: Retrieve detailed provider information including version and resources
  • list_provider_resources: List all resources available for a specific provider
  • get_terraform_resource_info: Get detailed information about a specific resource type
  • add_terraform_provider: Register new providers with versioning
  • add_terraform_resource: Add resource definitions with schemas
  • update_provider_version: Update provider versions with new documentation

Ansible Tools

  • get_ansible_collection_info: Get detailed information about an Ansible collection
  • list_ansible_collections: List all available Ansible collections
  • get_collection_version_history: View version history of a collection
  • get_ansible_module_info: Get detailed information about a specific module
  • list_collection_modules: List all modules in a collection
  • get_module_version_compatibility: Check version compatibility of modules
  • add_ansible_collection: Register new Ansible collections
  • add_ansible_module: Add new modules with validation and documentation

Entity Operations

  • create_entity: Create new infrastructure entities
  • update_entity: Modify existing entity configurations
  • delete_entity: Remove entities with relationship cleanup
  • view_relationships: Analyze entity dependencies and relationships

Configuration

The server supports configuration through environment variables:

  • DATABASE_URL: SQLite database location
  • MCP_DEBUG: Enable debug logging when set
  • MCP_TEST_MODE: Enable test mode for database resets

For development, create a .env file:

DATABASE_URL=sqlite:////path/to/db.sqlite
MCP_DEBUG=1
MCP_TEST_MODE=1

Integration with Claude Desktop

Development Setup

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

Production Setup

"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"
      }
  }
}

Development

Local Development

# Install dependencies
uv sync

# Run tests
uv run pytest

# Development server with MCP Inspector
npx @modelcontextprotocol/inspector uv run iac-memory-mcp-server

License

This project is licensed under the MIT License - see the LICENSE file for details.

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Bora Yalcin
  • Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.

  • https://jgadvisorycpa.com
  • This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • OffchainLabs
  • Go implementation of Ethereum proof of stake

  • modelcontextprotocol
  • Model Context Protocol Servers

  • huahuayu
  • A unified API gateway for integrating multiple etherscan-like blockchain explorer APIs with Model Context Protocol (MCP) support for AI assistants.

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

    Reviews

    5 (1)
    Avatar
    user_j3Bd2iIT
    2025-04-15

    I've been using the docs-mcp-server MCP Server by MCP-Mirror and it has significantly streamlined my workflow. The setup was straightforward with the clear start URL, and I found the welcoming information quite helpful. The server's performance is reliable and robust, making it an essential tool for my projects. Highly recommend!