Tangled MCP

🚀 tangled-mcp

Tangled 用のMCPサーバーです。Tangledは、AT Protocol上に構築されたGitコラボレーションプラットフォームです。

注意: このリポジトリは、FastMCP Cloud を通じたデプロイのために GitHub にミラーリングされています。

🚀 クイックスタート

📦 インストール

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=

💻 使用例

# 基本セットアップ
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)。オーナーには、@ プレフィックスの有無に関係なくハンドルとDIDの両方がサポートされています。

リポジトリ

• 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