Coverage Report

File	Stmts	Miss	Cover	Missing
src/aws_blackbelt_mcp_server
init.py	0	0	100%
config.py	10	0	100%
server.py	19	1	94%	39
src/aws_blackbelt_mcp_server/helpers
init.py	0	0	100%
path_resolver.py	12	0	100%
src/aws_blackbelt_mcp_server/tools
init.py	0	0	100%
seminars.py	80	9	88%	53, 129–130, 132, 191, 193, 205–206, 208
tests
init.py	0	0	100%
test_config.py	25	0	100%
test_server.py	7	0	100%
tests/helpers
init.py	0	0	100%
test_path_resolver.py	20	0	100%
tests/integration
init.py	0	0	100%
test_get_seminar_transcript.py	55	4	92%	24–27
test_search_seminars.py	49	0	100%
tests/tools
init.py	0	0	100%
test_seminars.py	27	0	100%
TOTAL	304	14	95%

AWS Black Belt MCP Server

A Model Context Protocol (MCP) server that provides search functionality for AWS Black Belt Online Seminars.

Tools

1. search_seminars: Search AWS Black Belt Online Seminars by keywords
2. get_seminar_transcript: Get transcript from seminar YouTube videos (Supported only in Japanese)

Current Information Sources

• AWS Black Belt Online Seminars
• PDF materials
• YouTube videos
• Seminar transcripts

Prerequisites

• Python 3.10 or higher
• uv package manager

Configuration

Amazon Q Developer CLI

For use with Amazon Q Developer CLI, add the following configuration to your MCP settings file:

• Workspace-level configuration: .aws/amazonq/cli-agents/default.json
• User-level configuration: ~/.aws/amazonq/cli-agents/default.json

Using uvx

{
  "mcpServers": {
    "aws-blackbelt-mcp-server": {
      "command": "uvx",
      "args": ["aws-blackbelt-mcp-server"]
    }
  }
}

Using Docker

{
  "mcpServers": {
    "aws-blackbelt-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/konippi/aws-blackbelt-mcp-server"
      ]
    }
  }
}

Basic Usage

Examples:

• "Find AWS Black Belt seminars about machine learning"
• "Get transcript from this seminar video: https://youtu.be/vWfTe5MHOIk"