Anyshift MCP Server

A toolkit for AWS infrastructure analysis and exploration through a Claude-powered conversational interface. This MCP server enables seamless integration of your infrastructure knowledge with various AI tools and platforms.

Overview

The Model Context Protocol (MCP) server provides a comprehensive set of tools for accessing and analyzing your infrastructure data through natural language queries. It integrates with various AI tools and platforms to provide context-aware infrastructure insights.

Documentation

For detailed documentation, visit our official documentation.

Prerequisites

• Node.js (v18+)
• Claude Desktop app
• Anyshift API Token (Get it from your Anyshift configuration page)

Configuration

Generate Anyshift MCP Token

• Go to the Anyshift configuration page
• Navigate to the MCP section
• Click on "Generate Token"
• Copy the generated token

Configure Claude Desktop

Add the following to your Claude desktop config file: (claude_desktop_config.json)

NPX

{
	"mcpServers": {
		"anyshift-mcp-server": {
			"command": "npx",
			"args": ["-y", "@anyshift/anyshift-mcp-server"],
			"env": {
				"API_TOKEN": "<API_TOKEN>"
			}
		}
	}
}

3. Testing Local Changes: To test local changes before publishing:

   {
   	"mcpServers": {
   		"anyshift-mcp-server": {
   			"command": "node",
   			"args": ["/path/to/ops/mcp-server/dist/anyshift_mcp_server.js"],
   			"env": {
   				"API_TOKEN": "<API_TOKEN>"
   			}
   		}
   	}
   }

   Or using npm:

   {
   	"mcpServers": {
   		"anyshift-mcp-server": {
   			"command": "npm",
   			"args": ["start", "--prefix", "/path/to/ops/mcp-server"],
   			"env": {
   				"API_TOKEN": "<API_TOKEN>"
   			}
   		}
   	}
   }

Docker

{
   "mcpServers": {
   "anyshift": {
      "command": "docker",
      "args": [
      "run",
      "--rm",
      "-i",
      "-e",
      "API_TOKEN",
      "anyshift/mcp"
      ],
      "env": {
         "API_TOKEN": "<API_TOKEN>"
      }
   }
}
}

Available Tools

The MCP server provides the following tools for infrastructure analysis:

• get_resource_types: Get a list of all resource types in the infrastructure
• search_graph_at_timestamp: Search the infrastructure graph at a specific timestamp
• get_graph_changes_over_timespan: Get changes in the infrastructure graph over a time period
• get_resource_history_over_timespan: Get the history of specific resources over a time period
• get_resources_details_at_timestamp: Get detailed information about resources at a specific timestamp
• execute_cypher: Execute a Cypher query against the infrastructure graph

Example Queries

Here are some example queries you can use with the MCP server:

• "List all IAM users in the engineering group"
• "Show me S3 buckets with public access"
• "What resources are in the production VPC?"
• "Display EC2 instances with their security groups"
• "Find resources missing required tags"

Available Integrations

• Cursor: Access infrastructure context while using Cursor for development tasks
• Claude Code: Access infrastructure context while using Claude Code
• Claude Desktop: Access infrastructure context while using Claude Desktop
• MCP Marketplace: Access Annie through various MCP marketplaces, including Smithery

Build

Docker build:

docker build -t anyshift/mcp -f Dockerfile .

License

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