What is Mcp Terraform Aws Provider Docs

mcp-terraform-aws-provider-docs is a Model Context Protocol (MCP) server built with Deno and TypeScript. It provides contextual information related to the Terraform AWS Provider, enabling users to access documentation and resources for AWS-related Terraform configurations.

Use cases

Use cases include querying documentation for Terraform AWS Provider, troubleshooting configurations, managing resources, and integrating with AI tools for automated infrastructure management.

How to use

To use mcp-terraform-aws-provider-docs, you can install it using Deno or Docker. It can also be integrated into various IDEs such as Cursor, Windsurf, and VSCode. Follow the installation instructions provided in the README to get started.

Key features

Key features include access to comprehensive resources documentation, provider configuration details, management of GitHub issues, and examples of AWS resources. It serves as a valuable tool for AI agents and developers working with Terraform.

Where to use

mcp-terraform-aws-provider-docs is suitable for developers, DevOps engineers, and teams working on infrastructure as code using Terraform, particularly in AWS environments.

MCP Server: Terraform AWS Provider Docs

A Model Context Protocol (MCP) server built with Deno
and TypeScript, designed to provide contextual information related to
Terraform AWS Provider.

Table of Contents

• MCP Server: Terraform AWS Provider Docs
  • Table of Contents
  • Overview
    • What is the Model Context Protocol (MCP) and how does it work?
    • Why?
  • Tools
  • Getting Started
    • Install and Use with Claude Desktop
      • Using Deno
      • Using Docker
    • Installing in IDE/Editor(s)o
      • Install on Cursor
      • Install on Windsurf
      • Install on VSCode
  • Developing & Contributing
    • Run it directly from JSR
    • Debugging & Troubleshooting
    • Using Docker
  • Roadmap
  • Contributing
  • Security
  • License

Overview

This server acts as an MCP server, exposing tools and resources that allow AI
agents or other MCP clients to query information about
Terraform AWS Provider
information, such as:

• ✅ Resources documentation.
• ✅ Provider’s configuration, including ephemeral resources, guides, and
  functions.
• ✅ GitHub Issues (opened, closed, and all)
• ✅ AWS Resources examples

What is the Model Context Protocol (MCP) and how does it work?

The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you’re building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.

— Model Context Protocol README

Why?

When writing IaC, or designing
terraform modules, it’s often
required a very good knowledge, understanding and context in the actual AWS
resources, features, and capabilities in order to design a production-grade
module, with stable interfaces, composable, and reusable.

This MCP server is designed to provide just that, with the latest documentation,
issues, and examples from the
Terraform AWS Provider
registry site. Always up-to-date, and always from the source.

Tools

[!IMPORTANT]
All tools require a valid GitHub token set as an environment variable:
GITHUB_TOKEN, GH_TOKEN, or GITHUB_PERSONAL_ACCESS_TOKEN.

Currently, the following tools are available (more to come, or feel free to
submit an
issue or
PR):

Getting Started

Install and Use with Claude Desktop

To use this Deno-based MCP server with Claude Desktop, add the following to your
claude_desktop_config.json:

Using Deno

{
  "mcpServers": {
    "tf_aws_provider_docs": {
      "command": "deno",
      "args": [
        "run",
        "-A",
        "main.ts"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Or, the recommended way, with deno directly from JSR

{
  "mcpServers": {
    "tf_aws_provider_docs": {
      "command": "deno",
      "args": [
        "run",
        "-A",
        "jsr:@excoriate/[email protected]"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Using Docker

{
  "mcpServers": {
    "tf_aws_provider_docs": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "GITHUB_TOKEN=<YOUR_TOKEN>",
        "mcp-terraform-aws-provider-docs"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Installing in IDE/Editor(s)o

Install on Cursor

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file
is the recommended approach. See
Cursor MCP docs for
more info.

{
  "mcpServers": {
    "tf_aws_provider_docs": {
      "command": "deno",
      "args": [
        "-A",
        "jsr:@excoriate/mcp-terraform-aws-provider-docs@latest"
      ]
    }
  }
}

Install on Windsurf

Add this to your Windsurf MCP config file. See
Windsurf MCP docs for more info.

{
  "mcpServers": {
    "tf_aws_provider_docs": {
      "command": "deno",
      "args": [
        "-A",
        "jsr:@excoriate/mcp-terraform-aws-provider-docs@latest"
      ]
    }
  }
}

Install on VSCode

Add this to your VSCode MCP config file. See
VSCode MCP docs
for more info.

{
  "servers": {
    "Context7": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "-A",
        "jsr:@excoriate/mcp-terraform-aws-provider-docs@latest"
      ]
    }
  }
}

Developing & Contributing

For more details about debugging, testing, and contributing to this project,
see DEVELOPER_GUIDE, and CONTRIBUTING.

Run it directly from JSR

You can use the MCP server directly from JSR (Javascript
Registry ❤️)

# export your github token
export GITHUB_TOKEN=ghp_xxx...

# run it
deno run -A jsr:@excoriate/mcp-terraform-aws-provider-docs@latest

Debugging & Troubleshooting

if you want to debug it, use the built-in debugger
(inspector). There’s a
justfile recipe to help you out.

# start the mcp server, and the inspector
just inspect

Using Docker

Build the Docker image

docker build -t mcp-terraform-aws-provider-docs .

Run the MCP server in Docker

docker run -it --rm \
  -e GITHUB_TOKEN=ghp_xxx... \
  mcp-terraform-aws-provider-docs

[!TIP]
Replace ghp_xxx... with your
GitHub Personal Access Token
with appropriate permissions.

You can also use GH_TOKEN or GITHUB_PERSONAL_ACCESS_TOKEN as the
environment variable name.

If you want to use a local .env file, you can pass it with
--env-file .env.

Roadmap

• [ ] Add tool to retrieve provider’s configuration.
• [ ] Integrated with dedicated backend, to index, and provide advance search/code assistant documentation avoiding GitHub API rate limits.

Contributing

See CONTRIBUTING.md for detailed contribution
guidelines, including setup, code style, PR process, and codebase structure
reference.

Security

See SECURITY.md for the project’s security policy, including how
to report vulnerabilities and responsible disclosure guidelines.

License

This project is licensed under the MIT License.