Metadata-Version: 2.4
Name: amazon-datazone-mcp-server
Version: 0.1.1
Summary: MCP server for AWS DataZone service - enables LLMs to interact with DataZone for data governance, cataloging, and management
Author-email: AWS Labs <aws-labs@amazon.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/awslabs/amazon-datazone-mcp-server
Project-URL: Documentation, https://github.com/awslabs/amazon-datazone-mcp-server/blob/main/docs/
Project-URL: Repository, https://github.com/awslabs/amazon-datazone-mcp-server
Project-URL: Issues, https://github.com/awslabs/amazon-datazone-mcp-server/issues
Project-URL: Changelog, https://github.com/awslabs/amazon-datazone-mcp-server/blob/main/CHANGELOG.md
Keywords: aws,datazone,mcp,model-context-protocol,data-governance,data-catalog
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Code Generators
Classifier: Environment :: Console
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: boto3>=1.26.0
Requires-Dist: mcp>=1.9.2
Requires-Dist: pydantic>=2.0.0
Requires-Dist: httpx>=0.24.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=1.1.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: pre-commit>=3.0.0; extra == "dev"
Requires-Dist: pyright>=1.1.350; extra == "dev"
Requires-Dist: ruff>=0.4.4; extra == "dev"
Dynamic: license-file

# Amazon DataZone MCP Server

[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Version](https://img.shields.io/badge/version-0.1.0-green.svg)](https://github.com/awslabs/amazon-datazone-mcp-server/releases)
[![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](LICENSE)
[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io/)

A high-performance Model Context Protocol (MCP) server that provides seamless integration with Amazon DataZone services. This server enables AI assistants and applications to interact with Amazon DataZone APIs through a standardized interface.

## Features

- **Complete Amazon DataZone API Coverage**: Access all major DataZone operations
- **Type Safety**: Full type hints and validation
- **Production Ready**: Robust error handling and logging
- **MCP Compatible**: Works with any MCP-compatible client

### Supported Operations

| Module | Operations |
|--------|------------|
| **Domain Management** | Create domains, manage domain units, search, policy grants |
| **Project Management** | Create/manage projects, project profiles, memberships |
| **Data Management** | Assets, listings, subscriptions, form types, data sources |
| **Glossary** | Business glossaries, glossary terms |
| **Environment** | Environments, connections, blueprints |

## Installation

```bash
pip install amazon-datazone-mcp-server
```

## Configuration

Configure AWS credentials using the standard AWS methods:
- AWS CLI: `aws configure`
- Environment variables: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_DEFAULT_REGION`
- IAM roles or instance profiles

## Running the Server

The server uses **stdio transport** for secure communication with MCP clients:

```bash
amazon-datazone-mcp-server
```

### Integration with MCP Clients

Configure in your MCP client (e.g., Claude Desktop):

```json
{
  "name": "amazon-datazone-mcp-server",
  "command": "amazon-datazone-mcp-server"
}
```

## Available Tools

The server provides **38 tools** across 5 categories:

### Domain Management
- `get_domain`, `create_domain`, `list_domains`
- `list_domain_units`, `create_domain_unit`
- `add_entity_owner`, `add_policy_grant`
- `search`, `search_types`
- User/group profile management

### Project Management
- `create_project`, `get_project`, `list_projects`
- `create_project_membership`, `list_project_memberships`
- Project profile management

### Data Management
- Asset operations: `get_asset`, `create_asset`, `publish_asset`
- Listing operations: `get_listing`, `search_listings`
- Data source management: `create_data_source`, `start_data_source_run`
- Subscription management: request, accept, get subscriptions
- Form type management

### Glossary Management
- `create_glossary`, `get_glossary`
- `create_glossary_term`, `get_glossary_term`

### Environment Management
- Environment operations: `list_environments`, `get_environment`
- Connection management: `create_connection`, `get_connection`, `list_connections`
- Blueprint operations: list and get blueprints and configurations

**Each tool includes comprehensive parameter documentation and examples accessible through your MCP client.**

## License

Licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

## Disclaimer

**This is an unofficial, community-developed project and is not affiliated with, endorsed by, or supported by Amazon Web Services, Inc.**

- AWS and DataZone are trademarks of Amazon.com, Inc. or its affiliates
- Users are responsible for their own AWS credentials, costs, and compliance
- No warranty or support is provided - use at your own risk
- Always follow AWS security best practices

For official Amazon DataZone documentation, visit [Amazon DataZone Documentation](https://docs.aws.amazon.com/datazone/).
