Conduit

🚀 Conduit - The MCP Server for Phabricator and Phorge

Conduit is a Model Context Protocol (MCP) server that seamlessly integrates with Phabricator and Phorge APIs. It empowers developers and tools with advanced automation and interaction capabilities.

✨ Features

• Modern HTTP Client: Built with httpx to support HTTP/2 and deliver better performance.
• MCP Integration: Comes with ready-to-use MCP tools for task management.
• Type Safety: Offers full type hints for an enhanced development experience.
• Secure: Employs token-based authentication with environment variable configuration.

📦 Installation

Via uvx

First, you need to install uv. If it's not installed, run the following command:

curl -LsSf https://astral.sh/uv/install.sh | sh

After installation, restart your shell or terminal to apply the environment variable changes.

Then run:

uvx --from git+https://github.com/mcpnow-io/conduit conduit-mcp

Docker

We're currently working on Docker support. We expect it to be available soon.

💻 Usage Examples

As HTTP/SSE Server

Conduit can function as an HTTP/SSE server for multi - user scenarios. This mode enables multiple clients to connect simultaneously, each using its own authentication token.

conduit-mcp --host 127.0.0.1 --port 8000 # or using python3 run.py if not installed this repo as package

When running as an HTTP server, authentication tokens are provided via HTTP headers instead of environment variables.

X-PHABRICATOR-TOKEN: your-32-character-token-here

📚 Documentation

Configuration

Before running the server, you need to set up the following environment variables:

Environment Variables

export PHABRICATOR_TOKEN=your-api-token-here
export PHABRICATOR_URL="https://your-phabricator-instance.com/api/"

export PHABRICATOR_PROXY="socks5://127.0.0.1:1080"  # Optional, if your network is behind a firewall
export PHABRICATOR_DISABLE_CERT_VERIFY=1  # Optional, if your network is under HTTPS filter (WARNING: Disabling certificate verification can expose you to security risks. Only set this if you trust your network environment.)

Note that in HTTPS/SSE mode, PHABRICATOR_TOKEN is NOT needed.

Getting Your API Token

1. Log into your Phabricator instance.
2. Go to Settings > API Tokens.
3. Generate a new token.
4. Copy the 32 - character token and use it as PHABRICATOR_TOKEN.

Contributing

There are multiple ways to contribute to this project:

• Submit bugs and feature requests and help us verify them as they are checked in.
• Review source code changes.
• Review the wiki and make pull requests for anything from typos to additional and new content.

If you're interested in fixing issues and contributing directly to the code base, please refer to the document How to Contribute:

• First-Time Setup
• Submitting a Pull Request
• Running Unittests

📄 License

Copyright (c) 2025 mpcnow.io. All rights reserved.

Licensed under the MIT license.