# PyGo MCP — Model Context Protocol Server for PyGo Framework

[![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg)](https://github.com/pygo-labs/pygo-mcp)
[![Python](https://img.shields.io/badge/Python-3.12+-blue?logo=python)](https://www.python.org/)
[![MCP](https://img.shields.io/badge/MCP-Protocol-orange)](https://modelcontextprotocol.io)

## 🚀 PyGo MCP

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives AI assistants (Claude, Cursor, etc.) deep awareness of the PyGo framework — its modules, types, and code generation capabilities.

## ✨ Features

- 🔧 **PyGo operations**: Generate code, query schema, inspect modules
- 📋 **Registry access**: List, search, and install PyGo modules
- 🎯 **AI-ready**: Designed for Claude Code, Cursor, Windsurf
- 🚀 **Deploy**: Live demo on GitHub Pages

## 📖 Usage

Install via pip:

```bash
pip install pygo-mcp
```

Add to MCP config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "pygo": {
      "command": "pygo-mcp"
    }
  }
}
```

Or use with `uv`:

```bash
uv tool install pygo-mcp
```

## 🛠️ Development

```bash
# Install dependencies
uv sync

# Run server in dev mode
mcp dev src/main.py --with-editable .

# Run directly
mcp run src/main.py

# Lint
uv run ruff check .
```

## 🎯 MCP Tools

| Tool | Description |
|------|-------------|
| `pygo_status` | Get PyGo framework status |
| `pygo_modules` | List/install PyGo modules |
| `pygo_generate` | Generate code from `.pgo` schema |
| `pygo_schema` | Query type schema |
| `pygo_help` | Get help for PyGo concepts |

## 📄 License

MIT — see [LICENSE](LICENSE).