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
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.fixBe 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.fixEnsure `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.fixAlways 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.