# MCP Foxxy Bridge

<!-- BADGIE TIME -->

[![CI/CD Pipeline](https://img.shields.io/github/actions/workflow/status/billyjbryant/mcp-foxxy-bridge/main.yml?branch=main&logo=github&label=CI%2FCD&style=for-the-badge)](https://github.com/billyjbryant/mcp-foxxy-bridge/actions/workflows/main.yml)
[![PyPI Version](https://img.shields.io/pypi/v/mcp-foxxy-bridge?logo=pypi&logoColor=white&style=for-the-badge)](https://pypi.org/project/mcp-foxxy-bridge/)
[![Python Version](https://img.shields.io/pypi/pyversions/mcp-foxxy-bridge?logo=python&logoColor=white&style=for-the-badge)](https://pypi.org/project/mcp-foxxy-bridge/)
[![License](https://img.shields.io/badge/license-AGPL--3.0--or--later-blue?logo=gnu&style=for-the-badge)](https://github.com/billyjbryant/mcp-foxxy-bridge/blob/main/LICENSE)

[![PyPI Downloads](https://img.shields.io/pypi/dm/mcp-foxxy-bridge?logo=pypi&logoColor=white&style=for-the-badge)](https://pypi.org/project/mcp-foxxy-bridge/)
[![GitHub Stars](https://img.shields.io/github/stars/billyjbryant/mcp-foxxy-bridge?logo=github&style=for-the-badge)](https://github.com/billyjbryant/mcp-foxxy-bridge/stargazers)
[![GitHub Issues](https://img.shields.io/github/issues/billyjbryant/mcp-foxxy-bridge?logo=github&style=for-the-badge)](https://github.com/billyjbryant/mcp-foxxy-bridge/issues)
[![Documentation](https://img.shields.io/badge/docs-available-brightgreen?logo=gitbook&style=for-the-badge)](https://github.com/billyjbryant/mcp-foxxy-bridge/tree/main/docs)

<!-- END BADGIE TIME -->

<p align="center">
  <img src="media/mcp-foxxy-bridge_logo_trimmed.webp" alt="MCP Foxxy Bridge Logo" width="300">
</p>

## Overview

**MCP Foxxy Bridge** is a secure one-to-many proxy for the Model Context Protocol (MCP). Connect multiple MCP servers through a single endpoint with enterprise-grade security.

**Key Features:**

- Single endpoint for all MCP servers
- OAuth 2.0 + PKCE authentication
- Enhanced CLI with daemon management
- REST API for operational control
- Secure command substitution
- HTTP/2 support

---

## Quickstart

### Installation

```bash
# Install via uv (recommended)
uv tool install mcp-foxxy-bridge

# Or install from GitHub
uv tool install git+https://github.com/billyjbryant/mcp-foxxy-bridge
```

---

### Quick Setup

```bash
# Initialize configuration
foxxy-bridge config init

# Add MCP servers
foxxy-bridge mcp add github "npx -y @modelcontextprotocol/server-github"
foxxy-bridge mcp add filesystem "npx -y @modelcontextprotocol/server-filesystem" --path ./

# Start the bridge server
foxxy-bridge server start

# Check status
foxxy-bridge server status
```

---

### Connect Your AI Tool

Point your MCP-compatible client to: `http://localhost:8080/sse`

---

## Documentation

**📖 Getting Started:**

- **[Installation Guide](docs/installation.md)** - Detailed setup and configuration
- **[Configuration Guide](docs/configuration.md)** - Configuration options and examples
- **[CLI Reference](docs/cli-reference.md)** - Complete command reference

**🔧 Advanced Topics:**

- **[API Reference](docs/api.md)** - REST API endpoints
- **[OAuth Authentication](docs/oauth.md)** - OAuth setup and security
- **[Daemon Management](docs/daemon-management.md)** - Background process management
- **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions

---

## Contributing & Support

- [Contributing Guide](CONTRIBUTING.md)
- [Issue Tracker](https://github.com/billyjbryant/mcp-foxxy-bridge/issues)
- [Discussions](https://github.com/billyjbryant/mcp-foxxy-bridge/discussions)

---

## Badges

[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/billyjbryant-mcp-foxxy-bridge-badge.png)](https://mseep.ai/app/billyjbryant-mcp-foxxy-bridge)

[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/0ebca7d0-f29c-4460-a8c1-1e8f14a6263e)

## License

AGPL-3.0-or-later - See [LICENSE](LICENSE) file for details.

---