Registry / aws / awslabs-eks-mcp-server

awslabs-eks-mcp-server

JSON →
library0.1.31pypypiunverified

The `awslabs-eks-mcp-server` package provides a Python-based server implementation for the Model Context Protocol (MCP), designed specifically for AWS EKS environments. It enables machine learning models to be served and managed efficiently within Kubernetes. As an AWS Labs 'sample' project, it demonstrates best practices and patterns but may not carry the same long-term support or stability guarantees as official AWS SDKs. The current version is `0.1.27`, with a release cadence that reflects ongoing development in a pre-1.0 state.

pip install awslabs-eks-mcp-server
INSTALL
IMPORT
SIG · AWSLABS-EKS-MCP-SE
A
awslabs-eks-mcp-server
awspythonv0.1.31
Install
9.0s avg
Import
Disk
162MB
Pass rate
8/ 10
Env Coverage8 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.1.31 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✓ —
✓ 10.48s
py 3.11
✓ —
✓ 9.4s
py 3.12
✓ —
✓ 7.98s
py 3.13
✓ —
✓ 7.95s
py 3.9
2/4 runs
2/4 runs
162MB installed
● package 162MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

ModelContextProtocolServer
from awslabs.eks_mcp_server.server import ModelContextProtocolServer
from awslabs.eks_mcp_server.server import ModelContextProtocolServer

This quickstart demonstrates how to create a basic MCP server. It involves defining a custom `ModelProvider` class that implements the necessary methods to serve model artifacts and context. The `ModelContextProtocolServer` wraps this provider, exposing a FastAPI application. The server is then run using `uvicorn`, typically accessible via `http://localhost:8000` (or the configured port). Remember to install `uvicorn` separately.

import uvicorn from mcp_server.server import ModelContextProtocolServer from mcp_server.provider import ModelProvider class MyModelProvider(ModelProvider): def __init__(self): super().__init__('my-model-provider-id') async def get_model_artifact_uri(self, model_id: str) -> str: # In a real scenario, this would return an S3 URI or similar print(f"Request for model_id: {model_id}") return f"s3://my-bucket/models/{model_id}/artifact.tar.gz" async def get_model_context(self, model_id: str) -> dict: # Return context specific to the model, e.g., framework, version return {"framework": "pytorch", "version": "1.13.1", "device": "cuda"} # Instantiate your model provider provider = MyModelProvider() # Create the MCP server instance app = ModelContextProtocolServer(provider=provider, port=8000) # Run the FastAPI app using Uvicorn # In a real deployment, you'd use a proper process manager (e.g., systemd, Kubernetes deployment) # For local testing, you can run this file directly and access http://localhost:8000/docs # Example of running the app via uvicorn programmatically if __name__ == "__main__": print("Starting MCP server on http://localhost:8000") # Use reload=True for development, remove in production uvicorn.run(app.get_app(), host="0.0.0.0", port=8000)
eks-mcp-server --version
Debug
Known issues
gotchaThis library is part of `aws-samples` and might not have the same level of official support, stability, or long-term maintenance guarantees as core AWS SDKs or services. It's intended as a reference implementation.
fix
Be aware that breaking changes might occur more frequently, and community support might be limited. Consider forks or alternative solutions for production critical workloads requiring enterprise-level support.
affects: All versions (0.1.x)
gotchaThe `awslabs-eks-mcp-server` package provides the server logic but requires `uvicorn` (or another ASGI server) to actually run the FastAPI application it exposes. `uvicorn` is not installed as a direct dependency.
fix
Ensure `uvicorn` is installed separately using `pip install uvicorn[standard]` or `pip install uvicorn` alongside the main library.
affects: All versions (0.1.x)
breakingAs a pre-1.0 version (0.1.x), the API surface of `awslabs-eks-mcp-server` is subject to breaking changes without adhering to strict semantic versioning. Methods, class names, or expected inputs may change between minor versions.
fix
Always pin to specific patch versions (e.g., `awslabs-eks-mcp-server==0.1.27`) in `requirements.txt` or `pyproject.toml` and thoroughly test when upgrading to newer versions. Refer to the GitHub repository's commit history for changes.
affects: All versions (0.1.x)
Upgrade
Version history
0.1.31latest on PyPI · released May 14, 2026
Audit
Dependencies
fastapirequiredUsed as the web framework for the MCP server.
uvicornrequiredASGI server required to run the FastAPI application.
boto3requiredAWS SDK for Python, often used for interacting with AWS services.
kubernetesrequiredKubernetes client for Python, for cluster interaction.
grpciorequiredRequired for the gRPC aspects of the Model Context Protocol.
protobufrequiredRequired for Protocol Buffers used in gRPC communication.
Agent activity
35 hits · last 30 days
node
30
OpenAI (training)
1
Resources
awslabs-eks-mcp-server — pip install awslabs-eks-mcp-server · libregistry