Metadata-Version: 2.4
Name: konokenj.cdk-api-mcp-server
Version: 0.27.0
Summary: An MCP server provides AWS CDK API Reference
Project-URL: Documentation, https://github.com/konokenj/cdk-api-mcp-server#readme
Project-URL: Issues, https://github.com/konokenj/cdk-api-mcp-server/issues
Project-URL: Source, https://github.com/konokenj/cdk-api-mcp-server
Author-email: Kenji Kono <konoken@amazon.co.jp>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.8
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: pydantic>=2.10.6
Provides-Extra: dev
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pygithub; extra == 'dev'
Requires-Dist: semantic-version; extra == 'dev'
Description-Content-Type: text/markdown

# CDK API MCP Server

[![PyPI - Version](https://img.shields.io/pypi/v/konokenj.cdk-api-mcp-server.svg)](https://pypi.org/project/konokenj.cdk-api-mcp-server)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/konokenj.cdk-api-mcp-server.svg)](https://pypi.org/project/konokenj.cdk-api-mcp-server)

<!-- DEP-VERSIONS-START -->
[![aws-cdk](https://img.shields.io/badge/aws%20cdk-v2.200.1-blue.svg)](https://github.com/konokenj/cdk-api-mcp-server/blob/main/current-versions/aws-cdk.txt)
<!-- DEP-VERSIONS-END -->

---

Provide AWS CDK API references and integration test code for sample. Can be used in offline because all documents are included in the released python artifact.

## Usage

Add to your mcp.json:

```json
{
  "mcpServers": {
    "konokenj.cdk-api-mcp-server": {
      "command": "uvx",
      "args": ["konokenj.cdk-api-mcp-server@latest"]
    }
  }
}
```

## MCP Server Capabilities

### Resource: CDK API packages

Registered as static resources. To get available modules under the package, call `list_resources()` as MCP client.

- `cdk-api-docs://constructs/@aws-cdk` ... Alpha modules published in `@aws-cdk` namespace
- `cdk-api-docs://constructs/aws-cdk-lib` ... Stable modules in `aws-cdk-lib` package

### Resource Template: List modules in package

To get available documents under the module, call `read_resource(uri)` as MCP client.

- `cdk-api-docs://constructs/@aws-cdk/{module}`
- `cdk-api-docs://constructs/aws-cdk-lib/{module}`

### Resource Template: Read file contents

To read a document, call `read_resource(uri)` as MCP client.

- `cdk-api-docs://constructs/@aws-cdk/{module}/{file}`
- `cdk-api-docs://constructs/aws-cdk-lib/{module}/{file}`

## License

Distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
