Iac Memory MCP Server

0 forks

0 stars

Free

What is iac-memory-mcp-server

iac-memory-mcp-server is a comprehensive server solution developed by Punkpeye for managing and analyzing Infrastructure-as-Code (IaC) resources. Utilizing the Model Context Protocol (MCP), this server provides a robust framework for AI systems to interact with IaC configurations, perform resource management tasks, and analyze infrastructure entities. It offers a streamlined approach to handling complex IaC environments by organizing and analyzing resources, making it easier for users to manage their infrastructure efficiently.

How to Use iac-memory-mcp-server

Getting started with iac-memory-mcp-server involves setting up your environment to allow efficient management of IaC resources. The server can be configured using environment variables, such as setting the path to the database, and defining client and server ports. Development and deployment configurations can be managed through a .env file for ease of use.

To interact with the server, users can perform various operations such as:

Search Resources: Use prompts to search for specific types of resources across cloud providers like AWS, Azure, and Google Cloud Platform.
Analyze Entities: Examine infrastructure entities to understand their configurations and relationships.

Users can also leverage the CRUD operations to manage their infrastructure entities and resources effectively:

Entity Operations: Create, read, update, and delete entities while analyzing their relationships.
Resource Operations: Add and manage resources using a custom URI scheme, allowing for easy access and manipulation of IaC configurations, documentation, and analysis results.

For development purposes, the server can be installed and configured on both MacOS and Windows platforms, supporting a seamless development workflow.

Key Features of iac-memory-mcp-server

iac-memory-mcp-server is packed with powerful features to enhance IaC resource management:

Custom Resource Management: Implements a unique resource:// URI scheme for accessing and manipulating internal resources, supporting various MIME types for different content formats.
Advanced Search and Analysis: Provides IaC-specific prompts to facilitate resource discovery and detailed entity analysis, helping users gain insights into their infrastructure's components and relationships.
Comprehensive CRUD Operations: Offers tools for entity management, including creating, reading, updating, and deleting entities, as well as analyzing their dependencies and relationships.
Flexible Configuration: Easily configurable through environment variables and .env files, enabling users to quickly adapt the server to their specific infrastructure needs.
Development and Debugging Support: Supports an efficient development workflow with capabilities for building, testing, and publishing applications, alongside recommended debugging practices for optimal performance.

By employing iac-memory-mcp-server, users can simplify their IaC management processes, making it easier to maintain complex infrastructure setups and gain valuable insights through effective analysis and resource management.

MCP Server for Infrastructure-as-Code (IaC) resource management and analysis.

Components

Resources

The server implements a resource management system with:

Custom resource:// URI scheme for accessing internal resources
Each resource has a name, content, and configurable MIME type
Resources can represent IaC configurations, documentation, and analysis results

Prompts

The server provides IaC-specific prompts for resource discovery and analysis:

search_resources

Search for Infrastructure-as-Code resources across providers:

result = await session.get_prompt("search_resources", {
 "provider": "aws", # Cloud provider (aws, azure, gcp)
 "resource_type": "s3_bucket" # Resource type to search
# Returns matching resources with schema versions and documentation

analyze_entity

Analyze infrastructure entities and their relationships:

result = await session.get_prompt("analyze_entity", {
 "entity_id": "entity-123", # ID of entity to analyze
 "include_relationships": "true" # Optional: include related entities
# Returns detailed analysis including:
# - Entity configuration
# - Recorded observations
# - Related entities (if requested)
# - Relationship types and depths

Tools

The server implements comprehensive CRUD operations: Entity Management and Relationships:

create_entity: Create new infrastructure entities
read_entity: Retrieve entity details
update_entity: Modify existing entities
delete_entity: Remove entities and related data
view_relationships: Analyze entity relationships and dependencies

# View all relationships
result = await session.call_tool("view_relationships", {})
# View relationships for specific entity
result = await session.call_tool("view_relationships", {
"entity_id": "entity-123"

Resource Management:

add_resource: Add new resources

# Add a new resource with custom MIME type
result = await session.call_tool("add_resource", {
"name": "aws-s3-config",
"content": "bucket_name: my-bucket\nregion: us-east-1",
"mime_type": "application/yaml" # Optional
# Add plain text resource
result = await session.call_tool("add_resource", {
"name": "deployment-notes",
"content": "Deployment steps for production..."

Configuration

The server can be configured through environment variables:

DATABASE_URL: Path to SQLite database file (default: in-memory)
CLIENT_PORT: Port for MCP Inspector client UI (default: 5173)
SERVER_PORT: Port for MCP Inspector proxy server (default: 3000) For development, you can also use a .env file:

DATABASE_URL=/path/to/db.sqlite
CLIENT_PORT=5173
SERVER_PORT=3000

Quickstart

Install

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json Development/Unpublished Servers Configuration

"mcpServers": {
"iac-memory-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/home/herman/Documents/vscode/iac-memory-mcp-server",
"run",
"iac-memory-mcp-server"

Published Servers Configuration

"mcpServers": {
"iac-memory-mcp-server": {
"command": "uvx",
"args": [
"iac-memory-mcp-server"

Development

Building and Publishing

To prepare the package for distribution:

Sync dependencies and update lockfile:

uv sync

Build package distributions:

uv build

This will create source and wheel distributions in the dist/ directory. 3. Publish to PyPI:

uv publish

Note: You'll need to set PyPI credentials via environment variables or command flags:

Token: --token or UV_PUBLISH_TOKEN
Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector. You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /home/herman/Documents/vscode/iac-memory-mcp-server run iac-memory-mcp-server

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

How to Use

To use the iac-memory-mcp-server, follow these steps:

Visit https://github.com/punkpeye/iac-memory-mcp-serverhttps://github.com/punkpe...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using iac-memory-mcp-server capabilities within your Claude conversations

Additional Information

Created

January 7, 2025

Company

punkpeye

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More