AI导哈

MCP服务器配置工具

Amazon Q的MCP服务器配置工具，用于设置和管理多种服务的Docker容器配置，包括Atlassian、GitHub等。

  • by AminNazirArtifax
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 aminnazirartifax/mcp-setup-guide

使用说明

Amazon Q MCP服务器设置指南

概述

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

配置文件

1. C:\Users\<username>\.aws\amazonq\mcp.json

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

2. C:\Users\<username>\.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://<your-domain>.atlassian.net/wiki",
    "CONFLUENCE_USERNAME": "<your-email>",
    "CONFLUENCE_API_TOKEN": "<your-confluence-token>",
    "JIRA_URL": "https://<your-domain>.atlassian.net",
    "JIRA_USERNAME": "<your-email>",
    "JIRA_API_TOKEN": "<your-jira-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": "<your-github-token>"
  }
}

获取API密钥和令牌

Atlassian API代币

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

GitHub个人访问令牌

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

安装说明

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

  2. 创建/编辑mcp.json:

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

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

  3. 创建/编辑default.json:

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

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

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

    • <username>：您的Windows用户名
    • <your-domain>：您的Atlassian域名
    • <your-email>：您的电子邮件地址
    • <your-confluence-token>：您的Confluence API令牌
    • <your-jira-token>：您的Jira API代币
    • <your-github-token>：您的GitHub个人访问令牌

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

文件之间的主要区别

特性 mcp.json default.json
范围 全局MCP服务器 特定于代理的配置
内容 仅服务器定义 服务器+工具+权限
工具阵列 不包括 列出可用工具
权限 未指定 定义允许的工具和设置
复杂性 简单的服务器配置 完整的代理配置

故障排除

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

相关 MCP