MCP Setup Guide

Amazon Q MCP服务器设置指南

概述

本指南解释了如何使用两个配置文件在Amazon Q中配置模型上下文协议（MCP）服务器。

配置文件

1. C:\Users\\.aws\amazonq\mcp.json

• 目的：全局MCP服务器配置
• 范围：适用于所有Amazon Q会话
• 包含：带命令和环境变量的基本MCP服务器定义

2. C:\Users\\.aws\amazonq\agents\default.json

• 目的：具有增强设置的特定于代理的配置
• 范围：特定于默认代理
• 包含：MCP服务器+工具配置、权限和高级设置

先决条件

• Docker桌面已安装并正在运行
• 要集成的服务的有效API令牌

MCP服务器配置结构

所有MCP服务器必须在 mcpServers 键入两个配置文件。以下是基本结构：

{
  "mcpServers": {
    "server-name-1": {
      "command": "docker",
      "args": [...],
      "env": {...}
    },
    "server-name-2": {
      "command": "docker",
      "args": [...],
      "env": {...}
    }
  }
}

支持的MCP服务器

1.Atlassian（Jira/Confluence）

"mcp-atlassian": {
  "command": "docker",
  "args": [
    "run", "-i", "--rm",
    "-e", "CONFLUENCE_URL",
    "-e", "CONFLUENCE_USERNAME", 
    "-e", "CONFLUENCE_API_TOKEN",
    "-e", "JIRA_URL",
    "-e", "JIRA_USERNAME",
    "-e", "JIRA_API_TOKEN",
    "ghcr.io/sooperset/mcp-atlassian:latest"
  ],
  "env": {
    "CONFLUENCE_URL": "https://.atlassian.net/wiki",
    "CONFLUENCE_USERNAME": "",
    "CONFLUENCE_API_TOKEN": "",
    "JIRA_URL": "https://.atlassian.net",
    "JIRA_USERNAME": "",
    "JIRA_API_TOKEN": ""
  }
}

2.背景7

"context7": {
  "command": "docker",
  "timeout": 60000,
  "args": [
    "run", "-i", "--rm",
    "-e", "MCP_TRANSPORT",
    "-e", "PORT",
    "mcp/context7"
  ],
  "env": {
    "MCP_TRANSPORT": "stdio",
    "PORT": "8089"
  }
}

3.GitHub

"github": {
  "command": "docker",
  "args": [
    "run", "-i", "--rm",
    "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": ""
  }
}

获取API密钥和令牌

Atlassian API代币

1. 首选 Atlassian帐户设置
2. 点击“创建API令牌”
3. 输入标签并单击“创建”
4. 复制生成的令牌

GitHub个人访问令牌

1. 前往GitHub设置>开发者设置>个人访问令牌
2. 点击“生成新令牌（经典）”
3. 选择所需的范围（repo、read:org等）
4. 点击“生成令牌”
5. 复制生成的令牌

安装说明

1. 安装Docker桌面 并确保其正常运行

1. 创建/编辑mcp.json:

   # Create the directory if it doesn't exist
   mkdir -p C:\Users\\.aws\amazonq

   # Edit the file
   notepad C:\Users\\.aws\amazonq\mcp.json

1. 创建/编辑default.json:

   # Create the directory if it doesn't exist
   mkdir -p C:\Users\\.aws\amazonq\agents

   # Edit the file
   notepad C:\Users\\.aws\amazonq\agents\default.json

1. 替换占位符 根据您的实际值：

- `：您的Windows用户名 - ：您的Atlassian域名 - ：您的电子邮件地址 - ：您的Confluence API令牌 - ：您的Jira API代币 - `：您的GitHub个人访问令牌

1. 重新启动亚马逊Q 加载新配置

文件之间的主要区别

故障排除

• 在启动Amazon Q之前，确保Docker正在运行
• 验证API令牌是否有效并具有所需的权限
• 检查所有占位符值是否已替换为实际凭据
• 配置更改后重新启动Amazon Q