flet-mcp 0.1.0__tar.gz

flet_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: flet-mcp
+Version: 0.1.0
+Summary: Flet MCP server for LLM agents
+Author-email: "Appveyor Systems Inc." <hello@flet.dev>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://flet.dev
+Project-URL: Repository, https://github.com/flet-dev/flet
+Project-URL: Documentation, https://flet.dev/docs
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: build
+Requires-Dist: markdownify>=0.14.1; extra == "build"
+Requires-Dist: griffe>=1.6.2; extra == "build"
+Requires-Dist: flet; extra == "build"
+Requires-Dist: flet-cli; extra == "build"
+
+# flet-mcp
+
+MCP (Model Context Protocol) server that gives LLM agents access to Flet examples, documentation, and API reference.
+
+## Installation
+
+```bash
+pip install flet-mcp
+```
+
+## Usage
+
+### Start the MCP server
+
+```bash
+# stdio transport (default, for use with Claude Desktop, Cursor, etc.)
+flet mcp
+
+# HTTP transport
+flet mcp --transport streamable-http --port 8000
+```
+
+### Configure in Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "flet": {
+      "command": "flet",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### List available tools
+
+```bash
+fastmcp list packages/flet-mcp/src/flet_mcp/server.py
+```
+
+### Call tools from the command line
+
+```bash
+# Search examples
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py search_examples '{"query": "dropdown"}'
+
+# Get full example code
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py get_example '{"example_id": "controls_dropdown_styled"}'
+
+# Search documentation
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py search_docs '{"query": "TextField validation"}'
+
+# Get control API reference
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py get_control_api '{"name": "TextField"}'
+
+# Find an icon
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py find_icon '{"query": "settings"}'
+
+# Search large enums
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py search_enum_members '{"name": "Icons", "query": "arrow"}'
+
+# Get CLI help
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py get_cli_help '{"command": "run"}'
+```
+
+### Use with Pydantic AI
+
+```python
+from pydantic_ai import Agent
+from pydantic_ai.toolsets import MCPToolset
+from flet_mcp import mcp
+
+agent = Agent("claude-sonnet-4-20250514", toolsets=[MCPToolset(mcp)])
+result = agent.run_sync("Create a Flet app with a login form")
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_examples` | Search example projects by keyword |
+| `get_example` | Get full source code for an example |
+| `search_docs` | Search documentation by keyword |
+| `get_doc` | Get full content of a doc section |
+| `list_controls` | List controls and services, with optional filtering |
+| `get_control_api` | Get properties, events, and methods for a control |
+| `get_type_api` | Get fields and methods for a type (ButtonStyle, Padding, etc.) |
+| `get_enum` | Get enum members |
+| `search_enum_members` | Search large enums (Icons, CupertinoIcons) |
+| `enum_has_member` | Check if an enum value exists |
+| `find_icon` | Search Material and Cupertino icons by keyword |
+| `get_cli_help` | Get structured CLI command options |

flet_mcp-0.1.0/README.md

@@ -0,0 +1,95 @@
+# flet-mcp
+
+MCP (Model Context Protocol) server that gives LLM agents access to Flet examples, documentation, and API reference.
+
+## Installation
+
+```bash
+pip install flet-mcp
+```
+
+## Usage
+
+### Start the MCP server
+
+```bash
+# stdio transport (default, for use with Claude Desktop, Cursor, etc.)
+flet mcp
+
+# HTTP transport
+flet mcp --transport streamable-http --port 8000
+```
+
+### Configure in Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "flet": {
+      "command": "flet",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### List available tools
+
+```bash
+fastmcp list packages/flet-mcp/src/flet_mcp/server.py
+```
+
+### Call tools from the command line
+
+```bash
+# Search examples
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py search_examples '{"query": "dropdown"}'
+
+# Get full example code
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py get_example '{"example_id": "controls_dropdown_styled"}'
+
+# Search documentation
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py search_docs '{"query": "TextField validation"}'
+
+# Get control API reference
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py get_control_api '{"name": "TextField"}'
+
+# Find an icon
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py find_icon '{"query": "settings"}'
+
+# Search large enums
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py search_enum_members '{"name": "Icons", "query": "arrow"}'
+
+# Get CLI help
+fastmcp call packages/flet-mcp/src/flet_mcp/server.py get_cli_help '{"command": "run"}'
+```
+
+### Use with Pydantic AI
+
+```python
+from pydantic_ai import Agent
+from pydantic_ai.toolsets import MCPToolset
+from flet_mcp import mcp
+
+agent = Agent("claude-sonnet-4-20250514", toolsets=[MCPToolset(mcp)])
+result = agent.run_sync("Create a Flet app with a login form")
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_examples` | Search example projects by keyword |
+| `get_example` | Get full source code for an example |
+| `search_docs` | Search documentation by keyword |
+| `get_doc` | Get full content of a doc section |
+| `list_controls` | List controls and services, with optional filtering |
+| `get_control_api` | Get properties, events, and methods for a control |
+| `get_type_api` | Get fields and methods for a type (ButtonStyle, Padding, etc.) |
+| `get_enum` | Get enum members |
+| `search_enum_members` | Search large enums (Icons, CupertinoIcons) |
+| `enum_has_member` | Check if an enum value exists |
+| `find_icon` | Search Material and Cupertino icons by keyword |
+| `get_cli_help` | Get structured CLI command options |

flet_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "flet-mcp"
+version = "0.1.0"
+description = "Flet MCP server for LLM agents"
+authors = [{ name = "Appveyor Systems Inc.", email = "hello@flet.dev" }]
+license = "Apache-2.0"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "fastmcp >=2.0.0",
+    "pyyaml >=6.0",
+]
+
+[project.optional-dependencies]
+build = [
+    "markdownify >=0.14.1",
+    "griffe >=1.6.2",
+    "flet",
+    "flet-cli",
+]
+
+[project.urls]
+Homepage = "https://flet.dev"
+Repository = "https://github.com/flet-dev/flet"
+Documentation = "https://flet.dev/docs"
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.package-data]
+flet_mcp = ["data/*"]

flet_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flet_mcp-0.1.0/src/flet_mcp/__init__.py

@@ -0,0 +1,3 @@
+from flet_mcp.server import mcp
+
+__all__ = ["mcp"]

flet_mcp-0.1.0/src/flet_mcp/api_store.py

@@ -0,0 +1,147 @@
+"""Load and query the Griffe-generated API reference (api.json)."""
+
+from __future__ import annotations
+
+import importlib.resources
+import json
+from pathlib import Path
+from typing import Any
+
+
+class ApiStore:
+    """Lazy-loading store for the bundled api.json data.
+
+    The api.json file uses lists for controls/events/types/enums,
+    each entry having a "name" key. This store builds name-keyed dicts
+    for fast lookup.
+    """
+
+    def __init__(self) -> None:
+        self._raw: dict[str, Any] | None = None
+        self._controls: dict[str, dict] | None = None
+        self._events: dict[str, dict] | None = None
+        self._types: dict[str, dict] | None = None
+        self._enums: dict[str, dict] | None = None
+
+    def _load(self) -> dict[str, Any]:
+        if self._raw is None:
+            ref = importlib.resources.files("flet_mcp").joinpath("data/api.json")
+            self._raw = json.loads(Path(str(ref)).read_text(encoding="utf-8"))
+            # Build name-keyed dicts from lists
+            self._controls = {c["name"]: c for c in self._raw.get("controls", [])}
+            self._events = {e["name"]: e for e in self._raw.get("events", [])}
+            self._types = {t["name"]: t for t in self._raw.get("types", [])}
+            self._enums = {e["name"]: e for e in self._raw.get("enums", [])}
+        return self._raw
+
+    # ------------------------------------------------------------------
+    # Controls
+    # ------------------------------------------------------------------
+
+    def list_controls(
+        self,
+        category: str | None = None,
+        kind: str | None = None,
+        limit: int = 50,
+    ) -> list[dict[str, Any]]:
+        """List controls, optionally filtered by category or kind."""
+        self._load()
+        results: list[dict[str, Any]] = []
+        for name, ctrl in self._controls.items():
+            if kind and ctrl.get("kind") != kind:
+                continue
+            if category and category not in ctrl.get("categories", []):
+                continue
+            results.append(
+                {
+                    "name": name,
+                    "kind": ctrl.get("kind"),
+                    "summary": ctrl.get("summary", ""),
+                    "categories": ctrl.get("categories", []),
+                }
+            )
+            if len(results) >= limit:
+                break
+        return results
+
+    def get_control(self, name: str) -> dict[str, Any] | None:
+        """Return full control dict by name, or None."""
+        self._load()
+        return self._controls.get(name)
+
+    # ------------------------------------------------------------------
+    # Types & Events
+    # ------------------------------------------------------------------
+
+    def get_type(self, name: str) -> dict[str, Any] | None:
+        """Return full type dict by name, or None."""
+        self._load()
+        return self._types.get(name) or self._events.get(name)
+
+    # ------------------------------------------------------------------
+    # Enums
+    # ------------------------------------------------------------------
+
+    def get_enum(self, name: str) -> dict[str, Any] | None:
+        """Return enum data. Large enums are truncated with a hint to search."""
+        self._load()
+        enum = self._enums.get(name)
+        if enum is None:
+            return None
+
+        if enum.get("kind") == "large_enum":
+            members = enum.get("members", [])
+            return {
+                "name": name,
+                "kind": "large_enum",
+                "total_members": len(members),
+                "sample_members": members[:10],
+                "note": (
+                    f"This enum has {len(members)} members. "
+                    "Use search_enum_members() to find specific values."
+                ),
+            }
+
+        return enum
+
+    def search_enum_members(self, name: str, query: str, limit: int = 10) -> list[str]:
+        """Search enum members by case-insensitive substring match."""
+        self._load()
+        enum = self._enums.get(name)
+        if enum is None:
+            return []
+
+        query_lower = query.lower()
+        results: list[str] = []
+        for member in enum.get("members", []):
+            member_name = member["name"] if isinstance(member, dict) else str(member)
+            if query_lower in member_name.lower():
+                results.append(member_name)
+                if len(results) >= limit:
+                    break
+        return results
+
+    def enum_has_member(self, name: str, member: str) -> bool:
+        """Check whether an enum contains a specific member."""
+        self._load()
+        enum = self._enums.get(name)
+        if enum is None:
+            return False
+        members = enum.get("members", [])
+        member_lower = member.lower()
+        return any(
+            (m["name"] if isinstance(m, dict) else str(m)).lower() == member_lower
+            for m in members
+        )
+
+    # ------------------------------------------------------------------
+    # CLI
+    # ------------------------------------------------------------------
+
+    def get_cli_help(self, command: str | None = None) -> Any:
+        """Return CLI help. None -> list commands; otherwise command help text."""
+        self._load()
+        cli = self._raw.get("cli", {})
+        if command is None:
+            return list(cli.keys())
+        return cli.get(command)