README - conduit by mcpnow-io

Conduit - The MCP Server for Phabricator and Phorge

Conduit is a Model Context Protocol (MCP) server that provides seamless integration with Phabricator and Phorge APIs, enabling advanced automation and interaction capabilities for developers and tools.

Conduit

Modern HTTP Client: Built with httpx for HTTP/2 support and better performance

MCP Integration: Ready-to-use MCP tools for task management

Type Safety: Full type hints for better development experience

Secure: Token-based authentication with environment variable configuration

Usage

Via `uvx`

You need to install uv first. If it is 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 are still working on Docker support. We estimate it will be available soon.

As HTTP/SSE Server

Conduit can run as an HTTP/SSE server for multi-user scenarios. This mode allows multiple clients to connect simultaneously, each using their own authentication tokens.

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

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.)

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

Getting Your API Token

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

Contributing

There are many ways in which you can participate in this project, for example:

Submit bugs and feature requests, and help us verify 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 are interested in fixing issues and contributing directly to the code base, please see the document How to Contribute：

License

Licensed under the license.