Tangled MCP

🚀 tangled-mcp

tangled-mcp 是為 Tangled 構建的 MCP 服務器，Tangled 是一個基於 AT 協議的 Git 協作平臺。

注意：此倉庫會鏡像到 GitHub，以便通過 FastMCP Cloud 進行部署。

🚀 快速開始

📦 安裝指南

git clone https://tangled.org/zzstoatzz/tangled-mcp
cd tangled-mcp
just setup

⚠️ 重要提示

此安裝過程需要 uv 和 just。

⚙️ 配置說明

創建 .env 文件：

TANGLED_HANDLE=your.handle
TANGLED_PASSWORD=your-app-password
# 可選：僅在使用自定義 PDS 時需要（留空以自動發現）
TANGLED_PDS_URL=

💻 使用示例

🌐 MCP 客戶端安裝說明

# 基本設置
claude mcp add tangled -- uvx tangled-mcp

# 帶憑證設置
claude mcp add tangled \
  -e TANGLED_HANDLE=your.handle \
  -e TANGLED_PASSWORD=your-app-password \
  -- uvx tangled-mcp

{
  "mcpServers": {
    "tangled": {
      "command": "uvx",
      "args": ["tangled-mcp"],
      "env": {
        "TANGLED_HANDLE": "your.handle",
        "TANGLED_PASSWORD": "your-app-password"
      }
    }
  }
}

codex mcp add tangled \
  --env TANGLED_HANDLE=your.handle \
  --env TANGLED_PASSWORD=your-app-password \
  -- uvx tangled-mcp

💻 開發使用示例

uv run tangled-mcp

📚 詳細文檔

📋 資源說明

• tangled://status - 連接狀態（PDS 認證 + Tangled 可訪問性）

🛠️ 工具說明

所有工具接受 owner/repo 格式的倉庫（例如 zzstoatzz/tangled-mcp）。所有者可以使用句柄（帶或不帶 @ 前綴）和 DIDs。

🔍 倉庫相關

• list_repo_branches(repo, limit, cursor) - 列出倉庫的分支

🐛 問題相關

• create_repo_issue(repo, title, body, labels) - 創建一個可選標籤的問題
• update_repo_issue(repo, issue_id, title, body, labels) - 更新問題的標題、正文和/或標籤
• delete_repo_issue(repo, issue_id) - 刪除一個問題
• list_repo_issues(repo, limit, cursor) - 列出倉庫的問題
• list_repo_labels(repo) - 列出倉庫可用的標籤

🔧 開發相關

just test   # 運行測試
just check  # 運行預提交檢查

mcp-name: io.github.zzstoatzz/tangled-mcp