How hashicorp/terraform-mcp-server works
Terraform MCP Server exposes Terraform Registry and HCP Terraform capabilities to MCP clients. The main workflow is client request → transport/server → tool selection and middleware → Registry or TFE API → MCP response; clients can connect over stdio or Streamable HTTP. Toolsets filter available tools, while session-scoped clients handle backend access. Resources provide Terraform guides, and HTTP-mode metrics support monitoring. Edges follow sampled calls or README-documented capabilities; unsampled subsystem links are omitted where their wiring is not shown.
Main entry points: server.go MCP server · http.go HTTP transport · flags.go CLI startup · tools.go Tool registration
Components 19
MCP entrypoints
- CLI startup
pkg/cli/flags.go - HTTP transport
pkg/mcp-mark3labs/http.go - Stdio transport
pkg/mcp-mark3labs/stdio.go - MCP server
pkg/mcp-mark3labs/server.go - Official SDK server
pkg/mcp-official/server.go
MCP capabilities
- Public Registry tools
pkg/tools/registry/search_providers.go - Terraform operations
pkg/tools/tfe - Guide resources
pkg/resources/resources.go - SDK tool registry
pkg/mcp-official/tools/registry/search_providers.go - SDK TFE tools
pkg/mcp-official/tools/tfe/teams_get_tool.go - Tool registration
pkg/mcp-official/tools/tools.go
Backend access
- Registry HTTP client
pkg/client/registry_client.go - TFE session client
pkg/client/tfe_client.go
Session and controls
- Toolset filtering
pkg/toolsets/filter.go - Request middleware
pkg/client/middleware.go - OTel metrics
pkg/otelmetrics/otelmetrics.go
Other components
- MCP client
- Terraform Registry
- HCP Terraform / TFE
Connections 22
- MCP client → HTTP transport: connects via HTTP
- MCP client → Stdio transport: connects via stdio
- CLI startup → HTTP transport: starts HTTP
pkg/cli/flags.go - CLI startup → Stdio transport: starts stdio
pkg/cli/flags.go - HTTP transport → MCP server: serves MCP
pkg/mcp-mark3labs/http.go - Stdio transport → MCP server: serves MCP
- MCP server → Toolset filtering: gates tools
pkg/mcp-mark3labs/server.go - MCP server → Guide resources: registers resources
pkg/mcp-mark3labs/server.go - MCP server → Public Registry tools: registers tools
pkg/mcp-mark3labs/server.go - MCP server → Terraform operations: registers tools
pkg/mcp-mark3labs/server.go - Official SDK server → Tool registration: registers tools
pkg/mcp-official/server.go - Tool registration → SDK tool registry: registers tools
pkg/mcp-official/tools/tools.go - Tool registration → SDK TFE tools: registers tools
pkg/mcp-official/tools/tools.go - Official SDK server → Toolset filtering: filters tools
pkg/mcp-official/server.go - Public Registry tools → Registry HTTP client: requests client
pkg/tools/registry/search_providers.go - Registry HTTP client → Terraform Registry: queries
- SDK tool registry → Registry HTTP client: requests client
pkg/mcp-official/tools/registry/search_providers.go - Terraform operations → TFE session client: requests client
pkg/tools/tfe/search_private_providers.go - SDK TFE tools → TFE session client: requests client
- TFE session client → HCP Terraform / TFE: calls API
- HTTP transport → Request middleware: configures controls
- CLI startup → OTel metrics: sets up metrics
pkg/cli/flags.go