Metadata-Version: 2.4
Name: nxd-tools
Version: 0.1.1
Summary: Collection of tools for working with MCP and other protocols
Author-email: Nextdata <dev@nextdata.com>
License: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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.10
Provides-Extra: dev
Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Provides-Extra: mcp-bridge
Requires-Dist: anyio>=4.8.0; extra == 'mcp-bridge'
Requires-Dist: httpx>=0.28.1; extra == 'mcp-bridge'
Requires-Dist: mcp>=1.1.2; extra == 'mcp-bridge'
Description-Content-Type: text/markdown

# nxd-tools

Collection of tools for working with MCP (Model Context Protocol) and other protocols.

## Installation

```bash
# Install the MCP bridge
pip install nxd-tools[mcp-bridge]

# Or with uv
uv pip install nxd-tools[mcp-bridge]
```

## Components

### MCP Bridge (`nxd-tools[mcp-bridge]`)

A stdio-to-HTTP proxy that enables stdio-based MCP clients (like Claude Desktop) to communicate with remote streamable HTTP MCP servers.

**Usage:**

```bash
# Using the console script
nxd-bridge --base-url https://server.example.com --token YOUR_TOKEN

# Using module invocation
python -m nxd_tools.mcp_bridge --base-url https://server.example.com --token YOUR_TOKEN

# Disable SSL verification (for development)
nxd-bridge --base-url https://server.example.com --token YOUR_TOKEN --no-ssl-verify
```

**Claude Desktop Configuration:**

Add to your Claude Desktop MCP settings:

```json
{
  "mcpServers": {
    "my-remote-server": {
      "command": "nxd-bridge",
      "args": [
        "--base-url",
        "https://server.example.com",
        "--token",
        "YOUR_TOKEN"
      ]
    }
  }
}
```

## Development

```bash
# Install with dev dependencies
uv pip install -e ".[dev,mcp-bridge]"

# Install pre-commit hooks
pre-commit install

# Run quality checks
ruff check . --fix
ruff format .

# Build package
python -m build
```
