konokenj.cdk-api-mcp-server 0.0.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

cdk_api_mcp_server/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2025-present Kenji Kono <konoken@amazon.co.jp>
 #
 # SPDX-License-Identifier: MIT
-__version__ = "0.0.1"
+__version__ = "0.2.0"

cdk_api_mcp_server/__init__.py

@@ -2,6 +2,6 @@
 #
 # SPDX-License-Identifier: MIT
 
-from .__about__ import __version__
+from cdk_api_mcp_server.__about__ import __version__
 
 __all__ = ["__version__"]

cdk_api_mcp_server/models.py

@@ -0,0 +1,24 @@
+"""AWS CDK API MCP model definitions."""
+
+from __future__ import annotations
+
+from typing import List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class FileItem(BaseModel):
+    """File item model for CDK API documentation."""
+
+    name: str = Field(description="Name of the file")
+    uri: str = Field(description="URI of the file")
+    is_directory: bool = Field(description="Whether the item is a directory")
+
+
+class FileList(BaseModel):
+    """List of files in CDK API documentation."""
+
+    files: List[FileItem] = Field(default_factory=list, description="List of files")
+    error: Optional[str] = Field(
+        default=None, description="Error message if files not found"
+    )

cdk_api_mcp_server/resources.py

@@ -0,0 +1,161 @@
+"""AWS CDK API MCP resource handlers."""
+
+from __future__ import annotations
+
+import json
+import logging
+from abc import ABC, abstractmethod
+from importlib.resources import files
+from pathlib import Path
+from typing import List
+
+# Set up logging
+logger = logging.getLogger(__name__)
+
+
+class ResourceProvider(ABC):
+    """リソースプロバイダーのインターフェース"""
+
+    @abstractmethod
+    def get_resource_content(self, path: str) -> str:
+        """リソースの内容を取得する"""
+
+    @abstractmethod
+    def list_resources(self, path: str) -> List[str]:
+        """指定パスのリソース一覧を取得する"""
+
+    @abstractmethod
+    def resource_exists(self, path: str) -> bool:
+        """リソースが存在するかチェックする"""
+
+
+class PackageResourceProvider(ResourceProvider):
+    """Pythonパッケージからリソースを提供するプロバイダー"""
+
+    def __init__(self, package_name: str = "cdk_api_mcp_server"):
+        self.package_name = package_name
+
+    def get_resource_content(self, path: str) -> str:
+        """新しいimportlib.resourcesのAPIを使用してパッケージからリソースを読み込む"""
+        try:
+            # 末尾のパス部分を分離（ディレクトリとファイル名）
+            parts = path.strip("/").split("/")
+
+            if len(parts) < 1:
+                return "Error: Invalid resource path"
+
+            # パスが"constructs"で始まる場合は"aws-cdk/constructs"に変換
+            if parts[0] == "constructs":
+                parts[0] = "aws-cdk/constructs"
+
+            # resources配下の実際のファイルへのパスを構築
+            base_path = files(self.package_name).joinpath("resources")
+
+            # パス要素を結合
+            resource_path = base_path
+            for part in parts[0].split("/"):
+                resource_path = resource_path.joinpath(part)
+
+            for part in parts[1:]:
+                resource_path = resource_path.joinpath(part)
+
+            # ファイルとして存在するかチェック
+            if resource_path.is_file():
+                return resource_path.read_text(encoding="utf-8")
+            elif resource_path.is_dir():
+                # ディレクトリの場合は内容一覧を返す
+                dir_contents = [entry.name for entry in resource_path.iterdir()]
+                return f"Directory: {path}\nContents: {', '.join(sorted(dir_contents))}"
+            else:
+                return f"Error: Resource '{path}' not found"
+        except (FileNotFoundError, IsADirectoryError, PermissionError) as e:
+            logger.debug(f"リソースの取得に失敗: {path} - {e}")
+            return f"Error: Resource '{path}' not found - {e!s}"
+
+    def list_resources(self, path: str) -> List[str]:
+        """新しいimportlib.resourcesのAPIを使用してパッケージ内のリソース一覧を取得する"""
+        try:
+            # resources配下の実際のディレクトリへのパスを構築
+            base_path = files(self.package_name).joinpath("resources")
+
+            # パス要素を結合
+            resource_path = base_path
+            if path:
+                parts = path.strip("/").split("/")
+                # パスが"constructs"で始まる場合は"aws-cdk/constructs"に変換
+                if parts[0] == "constructs":
+                    parts[0] = "aws-cdk/constructs"
+
+                # パスの最初の部分（"aws-cdk/constructs"を含む）を分割して追加
+                for part in parts[0].split("/"):
+                    resource_path = resource_path.joinpath(part)
+
+                # 残りのパス要素を追加
+                for part in parts[1:]:
+                    resource_path = resource_path.joinpath(part)
+
+            # ディレクトリとして存在するかチェック
+            if resource_path.is_dir():
+                items = sorted([entry.name for entry in resource_path.iterdir()])
+
+                # クライアントに返すときはハイフン形式に変換
+                if path and path.startswith("constructs/") and not path.endswith("/"):
+                    # ディレクトリでないパスの場合、モジュール名として扱いハイフン形式にする
+                    return [item.replace("_", "-") for item in items]
+                return items
+            else:
+                return []
+        except (FileNotFoundError, NotADirectoryError, PermissionError) as e:
+            logger.debug(f"リソース一覧の取得に失敗: {path} - {e}")
+            return []
+
+    def resource_exists(self, path: str) -> bool:
+        """新しいimportlib.resourcesのAPIを使用してリソースが存在するかチェックする"""
+        try:
+            # resources配下の実際のファイルへのパスを構築
+            base_path = files(self.package_name).joinpath("resources")
+
+            # パス要素を結合
+            resource_path = base_path
+            if path:
+                parts = path.strip("/").split("/")
+                # パスが"constructs"で始まる場合は"aws-cdk/constructs"に変換
+                if parts[0] == "constructs":
+                    parts[0] = "aws-cdk/constructs"
+
+                # パスの最初の部分（"aws-cdk/constructs"を含む）を分割して追加
+                for part in parts[0].split("/"):
+                    resource_path = resource_path.joinpath(part)
+
+                # 残りのパス要素を追加
+                for part in parts[1:]:
+                    resource_path = resource_path.joinpath(part)
+
+            # 存在チェック - Traversableには.exists()がないので、is_file()とis_dir()で確認
+            return resource_path.is_file() or resource_path.is_dir()
+        except (FileNotFoundError, PermissionError) as e:
+            logger.debug(f"リソースの存在チェックに失敗: {path} - {e}")
+            return False
+
+
+# Define resource directories for backward compatibility with tests
+CONSTRUCTS_DIR = Path(__file__).parent / "resources" / "aws-cdk" / "constructs"
+
+
+def get_package_content(provider: ResourceProvider, package_name: str) -> str:
+    """Get content for a package resource as a simple JSON array.
+
+    Args:
+        provider: Resource provider
+        package_name: Package name
+
+    Returns:
+        JSON array of module names as a string
+    """
+    resource_path = f"constructs/{package_name}"
+
+    if not provider.resource_exists(resource_path):
+        return "[]"  # 空の配列を返す
+    else:
+        modules = provider.list_resources(resource_path)
+        return json.dumps(modules)

cdk_api_mcp_server/server.py

@@ -1,8 +1,217 @@
-#!/usr/bin/env python3
 """AWS CDK API MCP server implementation."""
 
-from cdk_api_mcp_server.core.server import main
+import json
+import mimetypes
+import os
+from typing import Optional
 
+from fastmcp import FastMCP
+from fastmcp.resources import TextResource
+from pydantic import AnyUrl
 
-if __name__ == '__main__':
+from cdk_api_mcp_server.resources import (
+    PackageResourceProvider,
+    ResourceProvider,
+    get_package_content,
+)
+
+# MIMEタイプの初期化と追加
+mimetypes.init()
+mimetypes.add_type("text/markdown", ".md")
+mimetypes.add_type("text/typescript", ".ts")
+mimetypes.add_type("application/json", ".json")
+
+# デフォルトのMCPサーバーインスタンス
+mcp: FastMCP = FastMCP()
+# デフォルトのリソースプロバイダー
+_default_provider = PackageResourceProvider()
+
+
+def create_server(provider: Optional[ResourceProvider] = None) -> FastMCP:
+    """Create an MCP server with the given resource provider.
+
+    Args:
+        provider: ResourceProvider for CDK API resources. Defaults to PackageResourceProvider.
+
+    Returns:
+        FastMCP server instance with registered resources
+    """
+    # 使用するリソースプロバイダー
+    resource_provider = provider or _default_provider
+
+    # 新しいサーバーインスタンスを作成
+    server: FastMCP = FastMCP()
+
+    # nameフィールドにアクセスする方法は提供されていないため、descriptionを使う
+    server.description = "AWS CDK API MCP Server"
+
+    # 定義済みのパッケージとして直接リソース登録
+    @server.resource("cdk-api-docs://constructs/@aws-cdk", mime_type="application/json")
+    def get_aws_cdk_alpha_packages():
+        """Get AWS CDK Alpha modules published in @aws-cdk namespace."""
+        content = get_package_content(resource_provider, "@aws-cdk")
+
+        # JSONとしてレスポンスを返す
+        return TextResource(
+            uri=AnyUrl.build(
+                scheme="cdk-api-docs", host="constructs", path="/@aws-cdk"
+            ),
+            name="@aws-cdk",
+            text=content,
+            description="AWS CDK Alpha modules",
+            mime_type="application/json",  # JSONレスポンスのMIMEタイプを設定
+        )
+
+    @server.resource(
+        "cdk-api-docs://constructs/aws-cdk-lib", mime_type="application/json"
+    )
+    def get_aws_cdk_lib_packages():
+        """Get AWS CDK Stable modules in aws-cdk-lib package."""
+        content = get_package_content(resource_provider, "aws-cdk-lib")
+
+        # JSONとしてレスポンスを返す
+        return TextResource(
+            uri=AnyUrl.build(
+                scheme="cdk-api-docs", host="constructs", path="/aws-cdk-lib"
+            ),
+            name="aws-cdk-lib",
+            text=content,
+            description="AWS CDK Stable modules",
+            mime_type="application/json",  # JSONレスポンスのMIMEタイプを設定
+        )
+
+    # リソーステンプレート：パッケージ内のモジュール一覧
+    @server.resource(
+        "cdk-api-docs://constructs/{package_name}/", mime_type="application/json"
+    )
+    def list_package_modules(package_name: str):
+        """List all modules in a package."""
+        modules = [
+            item
+            for item in resource_provider.list_resources(f"constructs/{package_name}")
+            if resource_provider.resource_exists(f"constructs/{package_name}/{item}/")
+        ]
+        content = json.dumps(modules)
+
+        # JSONとしてレスポンスを返す
+        return TextResource(
+            uri=AnyUrl.build(
+                scheme="cdk-api-docs", host="constructs", path=f"/{package_name}/"
+            ),
+            name=f"{package_name}-modules",
+            text=content,
+            description=f"Modules in {package_name}",
+            mime_type="application/json",  # JSONレスポンスのMIMEタイプを設定
+        )
+
+    # リソーステンプレート：モジュール内のファイル一覧
+    @server.resource(
+        "cdk-api-docs://constructs/{package_name}/{module_name}/",
+        mime_type="application/json",
+    )
+    def list_module_files(package_name: str, module_name: str):
+        """List all files in a module."""
+        files = resource_provider.list_resources(
+            f"constructs/{package_name}/{module_name}"
+        )
+        content = json.dumps(files)
+
+        # JSONとしてレスポンスを返す
+        return TextResource(
+            uri=AnyUrl.build(
+                scheme="cdk-api-docs",
+                host="constructs",
+                path=f"/{package_name}/{module_name}/",
+            ),
+            name=f"{module_name}-files",
+            text=content,
+            description=f"Files in {package_name}/{module_name}",
+            mime_type="application/json",  # JSONレスポンスのMIMEタイプを設定
+        )
+
+    # リソーステンプレート：すべてのファイルタイプ対応
+    @server.resource(
+        "cdk-api-docs://constructs/{package_name}/{module_name}/{file_name}"
+    )
+    def get_construct_file(package_name: str, module_name: str, file_name: str):
+        """Get a file from the constructs directory."""
+        resource_path = f"constructs/{package_name}/{module_name}/{file_name}"
+
+        if not resource_provider.resource_exists(resource_path):
+            error_message = f"Error: File '{resource_path}' not found"
+            return TextResource(
+                uri=AnyUrl.build(
+                    scheme="cdk-api-docs",
+                    host="constructs",
+                    path=f"/{package_name}/{module_name}/{file_name}",
+                ),
+                name=file_name,
+                text=error_message,
+                description=f"Error: {resource_path}",
+                mime_type="text/plain",
+            )
+
+        # リソースプロバイダーからコンテンツを取得
+        content = resource_provider.get_resource_content(resource_path)
+
+        # 拡張子に基づいてMIMEタイプを決定
+        _, ext = os.path.splitext(file_name)
+
+        # 特定の拡張子に対して明示的にMIMEタイプを設定
+        if ext == ".md":
+            mime_type = "text/markdown"
+            description = f"Markdown file: {package_name}/{module_name}/{file_name}"
+        elif ext == ".ts":
+            mime_type = "text/typescript"
+            description = f"TypeScript file: {package_name}/{module_name}/{file_name}"
+        elif ext == ".json":
+            mime_type = "application/json"
+            description = f"JSON file: {package_name}/{module_name}/{file_name}"
+        else:
+            # その他の場合はmimetypesモジュールで判定
+            mime_type, _ = mimetypes.guess_type(file_name)
+            if mime_type is None:
+                # デフォルトはプレーンテキスト
+                mime_type = "text/plain"
+            description = f"File: {package_name}/{module_name}/{file_name}"
+
+        # Create and return a TextResource
+        return TextResource(
+            uri=AnyUrl.build(
+                scheme="cdk-api-docs",
+                host="constructs",
+                path=f"/{package_name}/{module_name}/{file_name}",
+            ),
+            name=file_name,
+            text=content,
+            description=description,
+            mime_type=mime_type,
+        )
+
+    return server
+
+
+# デフォルトのサーバーを初期化
+def initialize_default_server() -> None:
+    """Initialize the default MCP server with resources."""
+    global mcp
+    default_server = create_server(_default_provider)
+    # 以前のmcpの属性を新しいサーバーにコピー
+    mcp.__dict__.update(default_server.__dict__)
+
+
+# デフォルトサーバーを初期化
+initialize_default_server()
+
+
+def main():
+    """Run the MCP server."""
+    import logging
+
+    logging.basicConfig(level=logging.INFO)
+    # サーバーを実行
+    mcp.run()
+
+
+if __name__ == "__main__":
     main()

konokenj_cdk_api_mcp_server-0.2.0.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: konokenj.cdk-api-mcp-server
+Version: 0.2.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.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+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)
+
+---
+
+## 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.
+
+> [!Note]
+> Chagne first and second part of uri as you need.
+
+- `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.

konokenj_cdk_api_mcp_server-0.2.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+cdk_api_mcp_server/__about__.py,sha256=tp7Scy_xXYQk3Bk2RAr7QoM8qhKmY61oQNQYmcMNQUk,128
+cdk_api_mcp_server/__init__.py,sha256=yJA6yIEhJviC-qNlB-nC6UR1JblQci_d84i-viHZkc0,187
+cdk_api_mcp_server/models.py,sha256=cMS1Hi29M41YjuBxqqrzNrNvyG3MgnUBb1SqYpMCJ30,692
+cdk_api_mcp_server/resources.py,sha256=R7LVwn29I4BJzU5XAwKbX8j6uy-3ZxcB1b0HzZ_Z2PI,6689
+cdk_api_mcp_server/server.py,sha256=QTJ_e1sDU4Z64hinJFgApCwA2tKt_ma21jgRFw7ZBdw,7836
+cdk_api_mcp_server/resources/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+konokenj_cdk_api_mcp_server-0.2.0.dist-info/METADATA,sha256=floZlzg4_ivxSPAYYRIyeThv8AkCtZnOB1BIS1HKzPs,2678
+konokenj_cdk_api_mcp_server-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+konokenj_cdk_api_mcp_server-0.2.0.dist-info/entry_points.txt,sha256=bVDhMdyCC1WNMPOMbmB82jvWII2CIrwTZDygdCf0cYQ,79
+konokenj_cdk_api_mcp_server-0.2.0.dist-info/licenses/LICENSE.txt,sha256=5OIAASeg1HM22mVZ1enz9bgZ7TlsGfWXnj02P9OgFyk,1098
+konokenj_cdk_api_mcp_server-0.2.0.dist-info/RECORD,,

cdk_api_mcp_server/core/__init__.py

@@ -1 +0,0 @@
-"""Core module for CDK API MCP server."""

cdk_api_mcp_server/core/resources.py

@@ -1,121 +0,0 @@
-#!/usr/bin/env python3
-"""AWS CDK API MCP resource handlers."""
-
-import logging
-import os
-from pathlib import Path
-from typing import Optional
-
-
-# Set up logging
-logger = logging.getLogger(__name__)
-
-
-# Define resource directories
-DOCS_DIR = Path(__file__).parent.parent / "resources" / "aws-cdk" / "docs"
-INTEG_TESTS_DIR = Path(__file__).parent.parent / "resources" / "aws-cdk" / "integ-tests"
-
-
-async def get_cdk_api_docs(category: str, package_name: str, module_name: str, file_path: str) -> str:
-    """Get AWS CDK API documentation from the resources directory.
-
-    This resource handler serves documentation files from the resources/aws-cdk/docs directory.
-    The files are organized by category, package and module.
-
-    Example URIs:
-    - cdk-api-docs://packages/@aws-cdk/aws-s3/README.md
-    - cdk-api-docs://packages/aws-cdk-lib/aws-lambda/README.md
-    - cdk-api-docs://root/DEPRECATED_APIs.md
-
-    Args:
-        category: The category (e.g., 'packages', 'root')
-        package_name: The package name (e.g., '@aws-cdk', 'aws-cdk-lib')
-        module_name: The module name (e.g., 'aws-s3', 'aws-lambda')
-        file_path: The file path within the module (e.g., 'README.md')
-
-    Returns:
-        String containing the requested documentation
-    """
-    # Handle special case for root files like DEPRECATED_APIs.md
-    if category == "root":
-        file_path = os.path.join(DOCS_DIR, package_name)
-        if os.path.exists(file_path):
-            with open(file_path, 'r', encoding='utf-8') as f:
-                return f.read()
-        else:
-            return f"Error: File '{package_name}' not found"
-
-    # For packages category, construct the file path
-    if category == "packages":
-        if file_path:
-            file_path = os.path.join(DOCS_DIR, category, package_name, module_name, file_path)
-        else:
-            file_path = os.path.join(DOCS_DIR, category, package_name, module_name)
-    else:
-        # For other categories, construct the path accordingly
-        if file_path:
-            file_path = os.path.join(DOCS_DIR, category, package_name, module_name, file_path)
-        else:
-            file_path = os.path.join(DOCS_DIR, category, package_name, module_name)
-
-    # Check if the file exists
-    if os.path.exists(file_path):
-        # If it's a directory, list the contents
-        if os.path.isdir(file_path):
-            files = os.listdir(file_path)
-            result = f"# Contents of {package_name}/{module_name}\n\n"
-            for f in sorted(files):
-                if os.path.isdir(os.path.join(file_path, f)):
-                    result += f"- [{f}/](cdk-api-docs://{category}/{package_name}/{module_name}/{f})\n"
-                else:
-                    result += f"- [{f}](cdk-api-docs://{category}/{package_name}/{module_name}/{f})\n"
-            return result
-        # If it's a file, return the contents
-        else:
-            with open(file_path, 'r', encoding='utf-8') as f:
-                return f.read()
-    else:
-        return f"Error: File '{file_path}' not found"
-
-
-async def get_cdk_api_integ_tests(module_name: str, file_path: Optional[str] = None) -> str:
-    """Get AWS CDK integration test examples from the resources directory.
-
-    This resource handler serves integration test files from the resources/aws-cdk/integ-tests directory.
-    The files are organized by module.
-
-    Example URIs:
-    - cdk-api-integ-tests://aws-s3/aws-s3.test1.md
-    - cdk-api-integ-tests://aws-lambda/aws-lambda.handler.md
-
-    Args:
-        module_name: The module name (e.g., 'aws-s3', 'aws-lambda')
-        file_path: The file path within the module (e.g., 'aws-s3.test1.md')
-
-    Returns:
-        String containing the requested integration test example
-    """
-    # Construct the file path
-    if file_path:
-        file_path = os.path.join(INTEG_TESTS_DIR, module_name, file_path)
-    else:
-        file_path = os.path.join(INTEG_TESTS_DIR, module_name)
-
-    # Check if the file exists
-    if os.path.exists(file_path):
-        # If it's a directory, list the contents
-        if os.path.isdir(file_path):
-            files = os.listdir(file_path)
-            result = f"# Integration Tests for {module_name}\n\n"
-            for f in sorted(files):
-                if os.path.isdir(os.path.join(file_path, f)):
-                    result += f"- [{f}/](cdk-api-integ-tests://{module_name}/{f})\n"
-                else:
-                    result += f"- [{f}](cdk-api-integ-tests://{module_name}/{f})\n"
-            return result
-        # If it's a file, return the contents
-        else:
-            with open(file_path, 'r', encoding='utf-8') as f:
-                return f.read()
-    else:
-        return f"Error: File '{file_path}' not found"

cdk_api_mcp_server/core/server.py

@@ -1,255 +0,0 @@
-#!/usr/bin/env python3
-"""AWS CDK API MCP server implementation."""
-
-import logging
-import os
-import json
-from pathlib import Path
-from cdk_api_mcp_server.core import resources
-from fastmcp import FastMCP
-from fastmcp.resources import TextResource, DirectoryResource
-
-
-# Set up logging
-logger = logging.getLogger(__name__)
-
-
-# Define resource directories
-DOCS_DIR = Path(__file__).parent.parent / "resources" / "aws-cdk" / "docs"
-INTEG_TESTS_DIR = Path(__file__).parent.parent / "resources" / "aws-cdk" / "integ-tests"
-
-
-# Create MCP server
-mcp = FastMCP(
-    'AWS CDK API MCP Server',
-    dependencies=[],
-)
-
-
-# Register resource templates for hierarchical navigation
-@mcp.resource('cdk-api-docs://')
-async def list_root_categories():
-    """List all available categories in the CDK API documentation."""
-    if not DOCS_DIR.exists():
-        return {"error": "Documentation directory not found"}
-    
-    categories = []
-    # Add root category
-    categories.append({
-        "name": "root",
-        "uri": "cdk-api-docs://root/",
-        "description": "Root level documentation files",
-        "is_directory": True
-    })
-    
-    # Add packages category if it exists
-    packages_dir = DOCS_DIR / "packages"
-    if packages_dir.exists() and packages_dir.is_dir():
-        categories.append({
-            "name": "packages",
-            "uri": "cdk-api-docs://packages/",
-            "description": "AWS CDK packages documentation",
-            "is_directory": True
-        })
-    
-    return json.dumps({"categories": categories})
-
-
-@mcp.resource('cdk-api-docs://root/')
-def list_root_files():
-    """List all files in the root directory of the CDK API documentation."""
-    if not DOCS_DIR.exists():
-        return {"error": "Documentation directory not found"}
-    
-    files = []
-    for item in DOCS_DIR.iterdir():
-        if item.is_file():
-            files.append({
-                "name": item.name,
-                "uri": f"cdk-api-docs://root/{item.name}",
-                "is_directory": False
-            })
-        elif item.is_dir() and item.name != "packages":  # Skip packages dir as it's handled separately
-            files.append({
-                "name": item.name,
-                "uri": f"cdk-api-docs://root/{item.name}/",
-                "is_directory": True
-            })
-    
-    return json.dumps({"files": files})
-
-
-@mcp.resource('cdk-api-docs://root/{file_name}')
-def get_root_file(file_name: str):
-    """Get a file from the root directory of the CDK API documentation."""
-    file_path = DOCS_DIR / file_name
-    
-    if not file_path.exists() or not file_path.is_file():
-        return f"Error: File '{file_name}' not found"
-    
-    # Read the file content
-    with open(file_path, 'r', encoding='utf-8') as f:
-        content = f.read()
-    
-    # Create and return a TextResource
-    return TextResource(
-        uri=f"cdk-api-docs://root/{file_name}",
-        name=file_name,
-        text=content,
-        description=f"Root documentation file: {file_name}",
-        mime_type="text/markdown" if file_name.endswith(".md") else "text/plain"
-    )
-
-
-@mcp.resource('cdk-api-docs://packages/')
-def list_packages():
-    """List all packages in the CDK API documentation."""
-    packages_dir = DOCS_DIR / "packages"
-    
-    if not packages_dir.exists() or not packages_dir.is_dir():
-        return {"error": "Packages directory not found"}
-    
-    packages = []
-    for item in packages_dir.iterdir():
-        if item.is_dir():
-            packages.append({
-                "name": item.name,
-                "uri": f"cdk-api-docs://packages/{item.name}/",
-                "is_directory": True
-            })
-    
-    return json.dumps({"packages": packages})
-
-
-@mcp.resource('cdk-api-docs://packages/{package_name}/')
-def list_package_modules(package_name: str):
-    """List all modules in a specific package."""
-    package_dir = DOCS_DIR / "packages" / package_name
-    
-    if not package_dir.exists() or not package_dir.is_dir():
-        return {"error": f"Package '{package_name}' not found"}
-    
-    modules = []
-    for item in package_dir.iterdir():
-        if item.is_dir():
-            modules.append({
-                "name": item.name,
-                "uri": f"cdk-api-docs://packages/{package_name}/{item.name}/",
-                "is_directory": True
-            })
-        elif item.is_file():
-            modules.append({
-                "name": item.name,
-                "uri": f"cdk-api-docs://packages/{package_name}/{item.name}",
-                "is_directory": False
-            })
-    
-    return json.dumps({"modules": modules})
-
-
-@mcp.resource('cdk-api-docs://packages/{package_name}/{module_name}/')
-def list_module_files(package_name: str, module_name: str):
-    """List all files in a specific module."""
-    module_dir = DOCS_DIR / "packages" / package_name / module_name
-    
-    if not module_dir.exists() or not module_dir.is_dir():
-        return {"error": f"Module '{module_name}' not found in package '{package_name}'"}
-    
-    # ここでのみDirectoryResourceを使用
-    return DirectoryResource(
-        uri=f"cdk-api-docs://packages/{package_name}/{module_name}/",
-        name=f"Files in {package_name}/{module_name}",
-        path=module_dir,
-        description=f"List of files in the {package_name}/{module_name} module",
-        recursive=False
-    )
-
-
-@mcp.resource('cdk-api-docs://packages/{package_name}/{module_name}/{file_path}')
-def get_module_file(package_name: str, module_name: str, file_path: str):
-    """Get a specific file from a module."""
-    file_full_path = DOCS_DIR / "packages" / package_name / module_name / file_path
-    
-    if not file_full_path.exists() or not file_full_path.is_file():
-        return f"Error: File '{file_path}' not found in {package_name}/{module_name}"
-    
-    # Read the file content
-    with open(file_full_path, 'r', encoding='utf-8') as f:
-        content = f.read()
-    
-    # Create and return a TextResource
-    return TextResource(
-        uri=f"cdk-api-docs://packages/{package_name}/{module_name}/{file_path}",
-        name=file_path,
-        text=content,
-        description=f"Documentation file: {file_path} in {package_name}/{module_name}",
-        mime_type="text/markdown" if file_path.endswith(".md") else "text/plain"
-    )
-
-
-# Register integration tests resources
-@mcp.resource('cdk-api-integ-tests://')
-def list_integ_test_modules():
-    """List all modules with integration tests."""
-    if not INTEG_TESTS_DIR.exists():
-        return {"error": "Integration tests directory not found"}
-    
-    modules = []
-    for item in INTEG_TESTS_DIR.iterdir():
-        if item.is_dir():
-            modules.append({
-                "name": item.name,
-                "uri": f"cdk-api-integ-tests://{item.name}/",
-                "is_directory": True
-            })
-    
-    return json.dumps({"modules": modules})
-
-
-@mcp.resource('cdk-api-integ-tests://{module_name}/')
-def list_module_tests(module_name: str):
-    """List all integration tests for a specific module."""
-    module_dir = INTEG_TESTS_DIR / module_name
-    
-    if not module_dir.exists() or not module_dir.is_dir():
-        return {"error": f"Module '{module_name}' not found in integration tests"}
-    
-    # ここでのみDirectoryResourceを使用
-    return DirectoryResource(
-        uri=f"cdk-api-integ-tests://{module_name}/",
-        name=f"Integration tests for {module_name}",
-        path=module_dir,
-        description=f"List of integration tests for the {module_name} module",
-        recursive=False
-    )
-
-
-@mcp.resource('cdk-api-integ-tests://{module_name}/{file_path}')
-def get_module_test(module_name: str, file_path: str):
-    """Get a specific integration test file."""
-    file_full_path = INTEG_TESTS_DIR / module_name / file_path
-    
-    if not file_full_path.exists() or not file_full_path.is_file():
-        return f"Error: Integration test '{file_path}' not found for module '{module_name}'"
-    
-    # Read the file content
-    with open(file_full_path, 'r', encoding='utf-8') as f:
-        content = f.read()
-    
-    # Create and return a TextResource
-    return TextResource(
-        uri=f"cdk-api-integ-tests://{module_name}/{file_path}",
-        name=file_path,
-        text=content,
-        description=f"Integration test: {file_path} for {module_name}",
-        mime_type="text/markdown" if file_path.endswith(".md") else "text/plain"
-    )
-
-
-def main():
-    """Run the MCP server with CLI argument support."""
-    mcp.run()
-
-
-if __name__ == '__main__':
-    main()

konokenj_cdk_api_mcp_server-0.0.1.dist-info/METADATA

@@ -1,45 +0,0 @@
-Metadata-Version: 2.4
-Name: konokenj.cdk-api-mcp-server
-Version: 0.0.1
-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.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.8
-Requires-Dist: fastmcp>=2.0.0
-Requires-Dist: pydantic>=2.10.6
-Description-Content-Type: text/markdown
-
-# cdk-api-mcp-server
-
-[![PyPI - Version](https://img.shields.io/pypi/v/cdk-api-mcp-server.svg)](https://pypi.org/project/cdk-api-mcp-server)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/cdk-api-mcp-server.svg)](https://pypi.org/project/cdk-api-mcp-server)
-
------
-
-## Table of Contents
-
-- [Installation](#installation)
-- [License](#license)
-
-## Installation
-
-```console
-pip install cdk-api-mcp-server
-```
-
-## License
-
-`cdk-api-mcp-server` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

konokenj_cdk_api_mcp_server-0.0.1.dist-info/RECORD

@@ -1,12 +0,0 @@
-cdk_api_mcp_server/__about__.py,sha256=YDFhVrJ6IAPLvkmnNQeYbddiqs-wE-itcAwTO84Lt2U,128
-cdk_api_mcp_server/__init__.py,sha256=NEvU-xodn9HlOjf2mMHp_TfU-_2UkrV6zJRJSy5vt74,169
-cdk_api_mcp_server/server.py,sha256=XAG7UI1_Uy0F5Ff9qoL2z3FhLt5C9he39oHjhEYPhc4,157
-cdk_api_mcp_server/core/__init__.py,sha256=vDq0hUSCu3Tfj4EJyp5p40Ak5W68S4y_NkN5Z3pKAkA,42
-cdk_api_mcp_server/core/resources.py,sha256=yG0MPNAIYmnXioV3lSI3T1QkeelX5l83MddsbzKCZvs,4723
-cdk_api_mcp_server/core/server.py,sha256=KgCycgr7Yxnx4JeZHIk7oG1pz7YaXc1TOva9CclM5B4,8513
-cdk_api_mcp_server/resources/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-konokenj_cdk_api_mcp_server-0.0.1.dist-info/METADATA,sha256=y6E_ViH9EUcZMI0kvT7xz7grYG78aURNGUzGX1Aefr4,1601
-konokenj_cdk_api_mcp_server-0.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-konokenj_cdk_api_mcp_server-0.0.1.dist-info/entry_points.txt,sha256=bVDhMdyCC1WNMPOMbmB82jvWII2CIrwTZDygdCf0cYQ,79
-konokenj_cdk_api_mcp_server-0.0.1.dist-info/licenses/LICENSE.txt,sha256=5OIAASeg1HM22mVZ1enz9bgZ7TlsGfWXnj02P9OgFyk,1098
-konokenj_cdk_api_mcp_server-0.0.1.dist-info/RECORD,,