Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirA multi-profile proxy for the AWS MCP Server.
The AWS MCP Server authenticates each request with SigV4, so one connection
carries one AWS identity. awsmcproxy opens a connection per AWS profile,
mirrors the server's tools, and adds a profile argument to each tool. When a
tool is called, the proxy signs the request with that profile's credentials.
Claude Code ──stdio──▶ awsmcproxy ──┬─ profile=dev ─SigV4(dev)──▶ https://aws-mcp.us-east-1.api.aws/mcp
└─ profile=prod ─SigV4(prod)─▶ https://aws-mcp.us-east-1.api.aws/mcp
There is nothing to configure. Profiles come from ~/.aws/config and
~/.aws/credentials, and a list_profiles tool tells the agent which names it
can use.
It speaks the streamable HTTP transport and signs requests itself, so
mcp-proxy-for-aws and uvx are not
needed.
AWS credentials reachable through the standard credential chain: aws login,
aws sso login, assumed roles, credential_process and static keys all work.
aws login # or: aws sso login --profile my-dev
aws sts get-caller-identity
go install github.com/winebarrel/awsmcproxy/cmd/awsmcproxy@latest
Usage: awsmcproxy [flags]
Flags:
-h, --help Show help.
-e, --endpoint="https://aws-mcp.us-east-1.api.aws/mcp"
AWS MCP Server endpoint ($AWSMCPROXY_ENDPOINT).
--sso-role=STRING Override sso_role_name for every profile, e.g.
ReadOnlyAccess ($AWSMCPROXY_SSO_ROLE).
--version
The endpoint is a full URL, not a region, so it also reaches
https://aws-mcp.eu-central-1.api.aws/mcp or a Bedrock AgentCore gateway. The
SigV4 service and region are inferred from its hostname.
--sso-role replaces sso_role_name for every profile, keeping each profile's
own sso_account_id and SSO session:
awsmcproxy --sso-role ReadOnlyAccess
This is the way to stop an agent writing to AWS. Hiding write-capable tools would not be a boundary; a role that lacks the permissions is one.
The SSO access token is per session, not per role, so the role is swapped without logging in again. A role that is not assigned to you in that account fails when the credentials are first used, not at startup.
Only IAM Identity Center can do this: its GetRoleCredentials takes an account
and a role name, whereas AssumeRole needs the role's full ARN, which differs
per account. A profile that does not use IAM Identity Center is left alone and
keeps its own credentials.
Register it as an MCP server:
{
"mcpServers": {
"awsmcproxy": {
"command": "awsmcproxy"
}
}
}
Registering the proxy does not stop the agent reaching AWS another way. The
aws CLI is right there, and a call through it carries no profile argument,
is not signed by the proxy, and keeps none of the narrowing --sso-role was
set up to do. Deny it:
{
"permissions": {
"deny": ["Bash(aws *)"]
}
}
Put that in ~/.claude/settings.json to cover every project, or in a project's
.claude/settings.json. A deny rule beats any allow rule, is matched against
each subcommand of a pipeline separately, and is matched through a leading
environment assignment, so AWS_PROFILE=prod aws s3 rm ... is blocked as well.
Other spellings are not: /opt/homebrew/bin/aws and sh -c 'aws ...' both get
through. It routes the agent to the proxy; it is not a boundary. The boundary
is the role the credentials carry.
skills/awsmcproxy tells an agent how to drive the proxy: list the profiles
before the first call, ask when more than one name fits, and read an
AccessDenied as the answer rather than something to route around. Install it
with the skills CLI:
npx skills add winebarrel/awsmcproxy # into ./.claude/skills
npx skills add winebarrel/awsmcproxy -g # into ~/.claude/skills
Or copy skills/awsmcproxy into .claude/skills/ by hand. Either way Claude
Code picks it up on the next start.
initialize
right away, and tools/list and tools/call wait until the tools are loaded.
If loading fails, the proxy keeps running and returns the error from
tools/list.profile string argument. A
proxy-native list_profiles tool is also added, which reads ~/.aws/config
and ~/.aws/credentials on every call -- a profile added while the proxy is
running is usable right away, so the valid names are deliberately not frozen
into the tool schemas.profile argument, looks up that
profile's connection (opening it lazily, then caching it), and forwards the
call over it._meta
field as AWS_REGION, which is the default region for the AWS operations the
server runs. A failed call drops the connection, so the next one reconnects
with freshly retrieved credentials.Profile names are read the way aws-sdk-go-v2 reads them, so a name from
list_profiles is always a name the SDK accepts: in ~/.aws/config a
non-default profile needs the profile prefix, while in ~/.aws/credentials
it must not have one.
A multi-profile proxy for the AWS MCP Server: opens one SigV4-signed connection per AWS profile and adds a profile argument to every tool, so a single client connection can reach multiple AWS accounts
Visão geral
A multi-profile proxy for the AWS MCP Server: opens one SigV4-signed connection per AWS profile and adds a profile argument to every tool, so a single client connection can reach multiple AWS accounts. Needs no config file, no uvx and no mcp-proxy-for-aws.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Awsmcproxy roda localmente via stdio.
Última verificação: 2026-11-13. A multi-profile proxy for the AWS MCP Server: opens one SigV4-signed connection per AWS profile and adds a profile argument to every tool, so a single client connection can reach multiple AWS accounts. Needs no config file, no uvx and no mcp-proxy-for-aws.