PyPI version Python versions

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

search_seminars: Search AWS Black Belt Online Seminars by keywords
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",
        "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"

Metadata

Release files for aws-blackbelt-mcp-server 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aws-blackbelt-mcp-server 0.2.1
File	Size	Uploaded
aws_blackbelt_mcp_server-0.2.1.tar.gz	102.8 kB	Oct 12, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for aws-blackbelt-mcp-server 0.2.1
File	Interpreter	ABI	Platform	Reset
aws_blackbelt_mcp_server-0.2.1-py3-none-any.whl 12.1 kB Oct 12, 2025	Python 3	none	any	Details

Total release size: 114.9 kB

Release files / aws_blackbelt_mcp_server-0.2.1.tar.gz

Download URL	aws_blackbelt_mcp_server-0.2.1.tar.gz
Size	102.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`2ca78a7643967eb1df43a630591e8e00789a473f452a7515e868196190555e10`
BLAKE2b-256 checksum How to use checksums	`ee34e0b3c74a0e7b7b35aeaa7d0a846e5165195c46cd94889aeb1f858bf1e97d`
Upload date	Oct 12, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Konippi/aws-blackbelt-mcp-server
Publishing commit: github.com/Konippi/aws-blackbelt-mcp-server/tree/3113ff2cbba6b4f6c0f9323cb0f182874bb870f5

Workflow

Publishing configuration: github.com/Konippi/aws-blackbelt-mcp-server/blob/3113ff2cbba6b4f6c0f9323cb0f182874bb870f5/.github/workflows/release.yaml
Publishing logs: github.com/Konippi/aws-blackbelt-mcp-server/actions/runs/18445255072/attempts/1

Artifact

Subject: aws_blackbelt_mcp_server-0.2.1.tar.gz
SHA-256 checksum: 2ca78a7643967eb1df43a630591e8e00789a473f452a7515e868196190555e10 Verifying attestations

Release files / aws_blackbelt_mcp_server-0.2.1-py3-none-any.whl

Download URL	aws_blackbelt_mcp_server-0.2.1-py3-none-any.whl
Size	12.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6772282db05844ef24f32a458a8fd4338524b1434c7f8b24937ac63e8d674ea5`
BLAKE2b-256 checksum How to use checksums	`49de9f3581855e5f24dd1ac0c4059324f7bdee1b25ec89c7b5f5146f7b31df07`
Upload date	Oct 12, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Konippi/aws-blackbelt-mcp-server
Publishing commit: github.com/Konippi/aws-blackbelt-mcp-server/tree/3113ff2cbba6b4f6c0f9323cb0f182874bb870f5

Workflow

Publishing configuration: github.com/Konippi/aws-blackbelt-mcp-server/blob/3113ff2cbba6b4f6c0f9323cb0f182874bb870f5/.github/workflows/release.yaml
Publishing logs: github.com/Konippi/aws-blackbelt-mcp-server/actions/runs/18445255072/attempts/1

Artifact

Subject: aws_blackbelt_mcp_server-0.2.1-py3-none-any.whl
SHA-256 checksum: 6772282db05844ef24f32a458a8fd4338524b1434c7f8b24937ac63e8d674ea5 Verifying attestations