Open Source MCP Servers for AWS for Windsurf: Setup & Config

What you can do with Open Source MCP Servers for AWS in Windsurf

Choose task-specific AWS context and workflow integrations from a broad open-source server collection.

• Select specialized integrations for infrastructure and deployment workflows.
• Explore cloud development automation through MCP-compatible clients.

Before you start: Open Source MCP Servers for AWS in Windsurf

• An MCP-compatible client
• uvx for the documentation-server example

This is the AWS Documentation MCP Server configuration encoded in the README's installation link, not a command for the entire suite. The linked example uses ERROR logging and the aws documentation partition. Configure other servers separately; individual tool identifiers are not stated in the supplied excerpt.

Open Source MCP Servers for AWS Windsurf configuration

1. Choose Windsurf configuration scope

   For Open Source MCP Servers for AWS, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

2. Add Open Source MCP Servers for AWS to Windsurf

   Use the mcp entry below in mcpServers. Keep Open Source MCP Servers for AWS's documented stdio connection fields and your other Windsurf entries.

3. Check Open Source MCP Servers for AWS in Windsurf

   Open Source MCP Servers for AWS: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "awslabs.aws-documentation-mcp-server@latest"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "<desired logging level>",
        "AWS_DOCUMENTATION_PARTITION": "<AWS documentation partition>"
      }
    }
  }
}

Troubleshooting Open Source MCP Servers for AWS in Windsurf

• Check uvx awslabs.aws-documentation-mcp-server@latest (from uv, for Python tools) on the machine running Windsurf's MCP integration for Open Source MCP Servers for AWS; refresh MCP and inspect Cascade's tools.
• Check AWS_DOCUMENTATION_PARTITION, FASTMCP_LOG_LEVEL for Open Source MCP Servers for AWS; do not bypass a Windsurf permission error with a broad administrator token.
• Open Source MCP Servers for AWS uses stdio here: Windsurf must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: The repository describes local servers as stdio-only and removed SSE from current major versions.
• Known limitation: Production agent builders are directed toward the newer Agent Toolkit for AWS.
• Known limitation: A single universal tool catalog and launch command are not provided in the supplied excerpt.
• General Windsurf troubleshooting lives in the /clients/windsurf guide.

Frequently asked questions