Skip to content
PyGo

pygo-mcp — Model Context Protocol Server

pygo-mcp — Model Context Protocol Server

Section titled “pygo-mcp — Model Context Protocol Server”

pygo-mcp v0.1.0 — Model Context Protocol (MCP) server for PyGo Framework.

Gives AI assistants (Claude, Cursor, Windsurf) awareness of:

  • ✅ Framework status and modules
  • ✅ Type system and code generation
  • ✅ Module search and installation
  • ✅ Context-aware help and examples

🚀 Quick Start

Section titled “🚀 Quick Start”

Install in Claude Desktop

Section titled “Install in Claude Desktop”
  1. Clone the repo:
Terminal window
git clone https://github.com/PyGo-labs/pygo-mcp.git
cd pygo-mcp
  1. Add to claude_desktop_config.json:
{
  "mcpServers": {
    "pygo": {
      "command": "python",
      "args": ["-m", "mcp.server"],
      "env": {
        "PYTHONPATH": "/path/to/pygo-mcp"
      }
    }
  }
}
  1. Restart Claude Desktop.

Install in Cursor

Section titled “Install in Cursor”

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "pygo": {
      "command": "python3",
      "args": ["-m", "mcp.server"],
      "env": {
        "PYTHONPATH": "/path/to/pygo-mcp"
      }
    }
  }
}

🛠️ Available Tools

Section titled “🛠️ Available Tools”
Tool Description
pygo_status Get framework version + installed modules
pygo_modules List, search, or install PyGo modules
pygo_generate Generate code from .pgo DSL
pygo_schema Get model schema + type definitions
pygo_help Context-aware help + examples

🎯 Available Prompts

Section titled “🎯 Available Prompts”
Prompt Description
pygo_expert Full PyGo framework expertise
pygo_code_review Review PyGo code with best practices
pygo_debug Debug PyGo errors + suggest fixes

🔧 Usage Examples

Section titled “🔧 Usage Examples”

Ask Claude about PyGo

Section titled “Ask Claude about PyGo”

“Hey Claude, what modules are available in PyGo?”

Claude will call pygo_modules and return the registry listing.

Generate code with AI assistance

Section titled “Generate code with AI assistance”

“Help me create a User model with email validation in PyGo”

Claude can call pygo_generate to scaffold the code.

📦 Live Demo

Section titled “📦 Live Demo”

The MCP server is publicly available at:

https://pygo-mcp.vercel.app

Try the interactive playground: https://pygo-mcp.vercel.app/playground

🏗️ Architecture

Section titled “🏗️ Architecture”
pygo-mcp/
├── mcp/
│   ├── server.py      # MCP protocol handler
│   ├── tools.py       # Tool registrations
│   └── prompts.py     # AI prompt templates
├── src/main.py        # PyGo → Python generator
├── pygo.json          # Module manifest
└── vercel.json        # Deployment config

🔄 Integration with pygo-framework

Section titled “🔄 Integration with pygo-framework”

The MCP server hooks into the PyGo framework registry:

https://raw.githubusercontent.com/pygo-labs/pygo-registry/main/registry.json

Provides real-time awareness of:

  • Available modules
  • Version compatibility
  • Dependency chains
  • Feature availability

🚀 Next Steps

Section titled “🚀 Next Steps”