Metadata-Version: 2.4
Name: flet-mcp-server
Version: 0.1.0
Summary: Auto-updating MCP server for Flet documentation and packages
Project-URL: Homepage, https://github.com/Nwokike/flet-mcp-server
Project-URL: Repository, https://github.com/Nwokike/flet-mcp-server
Project-URL: Issues, https://github.com/Nwokike/flet-mcp-server/issues
Author-email: Onyeka Nwokike <nwokikeonyeka@gmail.com>
License: MIT
License-File: LICENSE
Keywords: agent,ai,documentation,flet,github-api,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: diskcache>=5.6.3
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.27.0
Provides-Extra: test
Requires-Dist: pytest-asyncio>=1.3.0; extra == 'test'
Requires-Dist: pytest-cov>=7.1.0; extra == 'test'
Requires-Dist: pytest>=9.0.3; extra == 'test'
Requires-Dist: ruff>=0.15.12; extra == 'test'
Description-Content-Type: text/markdown

# Flet MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Python: 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

An auto-updating Model Context Protocol (MCP) server that dynamically fetches, caches, and serves the official Flet documentation and ecosystem packages directly from GitHub and PyPI.

## Features

*   **GitHub Tree Sync**: Maps documentation in real-time.
*   **Intelligent Caching**: Uses `diskcache` for fast responses.
*   **Ecosystem Discovery**: Finds and verifies official and community Flet packages.
*   **AI-Optimized**: Tool definitions designed for LLM understanding.

## Tools Included

### 1. `list_flet_controls`
List all available Flet UI controls.

### 2. `search_flet_docs(query)`
Search the documentation index.

### 3. `get_flet_doc(doc_path)`
Get raw Markdown for a specific doc.

### 4. `list_official_packages()`
List official Flet extension packages.

### 5. `search_flet_ecosystem(query)`
Search for verified community Flet components.

### 6. `get_package_details(package_name)`
Fetch version and installation info from PyPI.

## Client Configuration Examples

### 🌌 Antigravity / Cascade
Add this to your `mcp_config.json`:

```json
{
  "mcpServers": {
    "flet-mcp-server": {
      "command": "uvx",
      "args": ["flet-mcp-server"]
    }
  }
}
```

### 🤖 Claude Desktop
Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "flet-mcp-server": {
      "command": "uvx",
      "args": ["flet-mcp-server"]
    }
  }
}
```

### 💻 Cursor / Windsurf
In your IDE's MCP settings, add a new server:
- **Name**: Flet MCP
- **Type**: Command
- **Command**: `uvx flet-mcp-server`

## Development

### Install
```bash
git clone https://github.com/Nwokike/flet-mcp-server.git
cd flet-mcp-server
uv sync
```

### Test
```bash
uv run pytest
```

## License
MIT
