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