conduit

🚀 Conduit - 用于Phabricator和Phorge的MCP服务器

Conduit是一个模型上下文协议（MCP）服务器，它能与Phabricator和Phorge API实现无缝集成，为开发者和工具提供高级自动化和交互功能。

✨ 主要特性

• 现代HTTP客户端：基于httpx构建，支持HTTP/2协议，性能更优。
• MCP集成：提供即用型MCP工具，用于任务管理。
• 类型安全：提供完整的类型提示，带来更好的开发体验。
• 安全可靠：采用基于令牌的身份验证，并通过环境变量进行配置。

🚀 快速开始

📦 安装指南

通过uvx安装

首先，你需要安装uv。若尚未安装，请运行以下命令：

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

安装完成后，重启你的Shell或终端，以使环境变量更改生效。

然后运行：

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

使用Docker（待支持）

我们正在努力实现Docker支持，预计很快就会推出。

💻 使用示例

作为HTTP/SSE服务器

Conduit可以作为HTTP/SSE服务器运行，适用于多用户场景。此模式允许多个客户端同时连接，每个客户端使用自己的身份验证令牌。

conduit-mcp --host 127.0.0.1 --port 8000 # 若未将此仓库作为包安装，也可使用python3 run.py

当作为HTTP服务器运行时，身份验证令牌通过HTTP头而非环境变量提供。

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

📚 详细文档

配置

在运行服务器之前，你需要设置以下环境变量：

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"  # 可选，若你的网络位于防火墙之后
export PHABRICATOR_DISABLE_CERT_VERIFY=1  # 可选，若你的网络受到HTTPS过滤（警告：禁用证书验证会带来安全风险，仅在信任网络环境时设置）

请注意，在HTTPS/SSE模式下，不需要设置PHABRICATOR_TOKEN。

获取API令牌

1. 登录到你的Phabricator实例。
2. 转到“设置”>“API令牌”。
3. 生成一个新令牌。
4. 复制32位字符的令牌，并将其用作PHABRICATOR_TOKEN。

🔗 贡献代码

你可以通过多种方式参与本项目，例如：

• 提交错误报告和功能请求，并在问题被检查时协助验证。
• 审查源代码变更。
• 审查Wiki，并对其中的错别字、补充内容和新内容提出拉取请求。

如果你有兴趣修复问题并直接为代码库做出贡献，请参阅文档如何贡献：

• 首次设置
• 提交拉取请求
• 运行单元测试

📄 许可证

版权所有 (c) 2025 mpcnow.io。保留所有权利。

本项目根据MIT许可证授权。