q MCP

MCP Docker服务器

带有Terraform、GitHub CLI、AWS CLI和文件系统工具的MCP服务器。

设置

先决条件

1. 使用AWS进行身份验证：

   aws sso login --profile 
   export AWS_DEFAULT_PROFILE=

1. 通过GitHub进行身份验证：

   gh auth login

启动服务器

1. 构建并启动容器：

   docker-compose up -d --build

1. 验证它是否正在运行：

   docker ps | grep mcp-tools

IDE 集成

代理配置位于 .amazonq/agents/docker-mcp.json.

要在IDE中使用它：

• MCP服务器在 mcp-tools 容器
• AWS凭据从以下位置装载 ~/.aws （只读）-必须运行 aws sso login 在主机上
• GitHub凭据从以下位置挂载 ~/.config/gh （只读）-必须运行 gh auth login 在主机上
• 工作目录装载在 /workspace

可用工具

• fs_read -读取文件
• fs_write -写入文件
• fs_list -列出目录内容
• 外壳 -运行shell命令
• 地形改造 -运行地形命令
• 鬼 -运行GitHub CLI命令
• 亚马逊网络服务 -运行AWS CLI命令

用法示例

# Test the server manually
docker exec -i mcp-tools node /mcp/mcp-server.js

# Run terraform
docker exec mcp-tools terraform version

# Run AWS CLI
docker exec mcp-tools aws s3 ls

# Run GitHub CLI
docker exec mcp-tools gh --version

停止

docker-compose down