Metadata-Version: 2.4
Name: alpenglow-mcp-bridge
Version: 1.0.2
Summary: Connect Claude Desktop to Odoo via the Alpenglow MCP Connector
Project-URL: Homepage, https://apps.odoo.com/apps/modules/19.0/alpenglow_mcp/
Author: Alpenglow Software
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,erp,mcp,odoo
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# Alpenglow MCP Bridge

Connect Claude Desktop (or any MCP client) to your Odoo instance through the
[Alpenglow MCP Connector](https://apps.odoo.com/apps/modules/19.0/alpenglow_mcp/).

The bridge runs locally on your machine and translates MCP stdio protocol into
HTTP requests to your Odoo server. All business logic, access control, and
rate limiting stay on the server.

## Prerequisites

- An Odoo 19 instance with the **Alpenglow MCP Connector** module installed
- An API key generated through the Alpenglow setup wizard
- Python 3.10+ (or install via `uv` / `uvx` which handles this automatically)

## Quick start

### Option A: Run with uvx (recommended)

Install [uv](https://docs.astral.sh/uv/getting-started/installation/) if you
don't have it, then run:

```bash
uvx alpenglow-mcp-bridge --url https://your-odoo.com --token YOUR_API_KEY
```

### Option B: Install with pip

```bash
pip install alpenglow-mcp-bridge
alpenglow-mcp-bridge --url https://your-odoo.com --token YOUR_API_KEY
```

## Claude Desktop configuration

Add this to `~/.claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "alpenglow-odoo": {
      "command": "uvx",
      "args": [
        "alpenglow-mcp-bridge",
        "--url", "https://your-odoo.com",
        "--token", "YOUR_API_KEY"
      ]
    }
  }
}
```

## Environment variables

Instead of CLI flags, you can set:

- `ALPENGLOW_URL` — Odoo instance URL
- `ALPENGLOW_TOKEN` — API key

## Available tools

| Tool | Description |
|------|-------------|
| `alpenglow_list_models` | List available Odoo models |
| `alpenglow_describe` | Get full schema for a model |
| `alpenglow_search` | Search records with filters and pagination |
| `alpenglow_read` | Read records by ID |
| `alpenglow_create` | Create new records |
| `alpenglow_update` | Update existing records |
| `alpenglow_delete` | Delete records |
| `alpenglow_aggregate` | Run reporting queries (count, sum, avg, group_by, trend, etc.) |
| `alpenglow_execute` | Call whitelisted ORM methods |

## License

MIT
