feat(aws-msk-mcp-server): add ListTopics, DescribeTopic, DescribeTopicPartitions APIs & tests

[ar7u4]

Fixes

N/A

Summary

Changes

• New Read Tool: Added get_topic_info under awslabs/aws_msk_mcp_server/tools/read_topic. This exposes three MSK Topic APIs:
  • list_topics — wrapper for kafka.list_topics (supports MaxResults / pagination).
  • describe_topic — wrapper for kafka.describe_topic.
  • describe_topic_partitions — wrapper for kafka.describe_topic_partitions (supports MaxResults / pagination).
• Registration: Registered get_topic_info in __init__.py.
• Testing: Added unit tests (test_list_topics.py, test_describe_topic.py, test_describe_topic_partitions.py) which mock the boto3 kafka client to validate success and error paths.
• Documentation:
  • Updated README.md to add a "Topic Operations" section with usage examples for get_topic_info.
  • Updated the repository root README.md to note MSK topic viewing capability in the servers table.
• Dev Environment: Installed pytest-asyncio in the development venv to satisfy existing pytest configuration.

User experience

Before:
MCP clients had cluster-level MSK read tools but no dedicated topic-level helpers exposed as a read tool.

After:
MCP clients can invoke get_topic_info with action=list|describe|partitions to:

• List topics in a cluster.
• Get topic metadata.
• Inspect topic partition metadata.

This improves observability and enables LLM-driven workflows that require specific topic or partition data.

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• I have reviewed the [contributing guidelines](https://github.com/awslabs/mcp/blob/main/CONTRIBUTING.md)
• I have performed a self-review of this change
• Changes have been tested (unit tests added and run locally)
• Changes are documented (existing READMEs updated)

Is this a breaking change? (Y/N)
N

RFC issue number: N/A

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.