Skeleton MCP Server

Instructions

Implementation Reference

• src/skeleton_mcp/api/example.py:104-140 (handler)

  The handler function that implements the create_item tool logic, generating a mock item ID and storing it in MOCK_ITEMS.

  async def create_item(
      name: str,
      description: str | None = None,
      metadata: dict[str, str] | None = None,
  ) -> dict[str, Any]:
      """
      Create a new item.
  
      Args:
          name: The name of the item (required)
          description: Optional description
          metadata: Optional key-value metadata
  
      Returns:
          The created item data including the generated ID
      """
      # In a real implementation:
      # client = get_client()
      # return client.post("items", data={"name": name, "description": description, "metadata": metadata})
  
      import uuid
      from datetime import datetime, timezone
  
      item_id = f"item-{uuid.uuid4().hex[:8]}"
      now = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
  
      item = {
          "id": item_id,
          "name": name,
          "description": description,
          "metadata": metadata,
          "created_at": now,
          "updated_at": now,
      }
  
      MOCK_ITEMS[item_id] = item
      return item

• src/skeleton_mcp/server.py:91-91 (registration)

  Registers the create_item function from the example API as an MCP tool.

  mcp.tool()(example.create_item)

• src/skeleton_mcp/api/example.py:104-108 (schema)

  The function signature and docstring define the input schema (name required, optional description and metadata) and output (dict with item data).

  async def create_item(
      name: str,
      description: str | None = None,
      metadata: dict[str, str] | None = None,
  ) -> dict[str, Any]:

• src/skeleton_mcp/server.py:23-23 (registration)

  Imports the example module containing the create_item handler for registration.

  from .api import example