Metadata-Version: 2.4
Name: hexfuture-mcp
Version: 1.0.1
Summary: HexFuture MCP connector — local stdio proxy with browser-based auto-login
License: MIT
Keywords: mcp,hexfuture,connector,workbuddy
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp<2.0.0,>=1.0.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: mypy>=1.8; extra == "dev"

# hexfuture-mcp

HexFuture MCP connector for WorkBuddy. A local stdio proxy that bridges WorkBuddy to a remote HexFuture HTTP MCP server, with browser-based auto-login.

## Installation

```bash
pip install hexfuture-mcp
```

Or use with `uvx` (no install needed):

```bash
uvx hexfuture-mcp
```

## Usage

Configure in WorkBuddy's `mcp.json`:

```json
{
  "mcpServers": {
    "connector:hexfuture": {
      "type": "stdio",
      "command": "uvx",
      "args": ["hexfuture-mcp"],
      "env": {
        "HEX_MCP_URL": "https://your-server.com"
      },
      "timeout": 60000
    }
  }
}
```

On first run, a browser window will open for login. The API key is stored locally at `~/.hexfuture/apikey.json` and automatically refreshed on expiry.

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `HEX_MCP_URL` | Remote MCP server base URL | `http://localhost:3000` |

## License

MIT
