Tusky MCP Server

🚀 用於將Tusky與Claude和其他MCP兼容AI系統集成的模型上下文協議（MCP）服務器

本項目搭建了一座橋樑，連接Tusky存儲/Mastodon集成與採用模型上下文協議（MCP）的AI助手。藉助它，Claude等兼容AI能通過標準接口安全地訪問和操作Tusky中的數據。

✨ 主要特性

• 支持使用Tusky API進行身份驗證。
• 可對Tusky保險庫中的文件和文件夾進行管理。
• 能管理用戶配置文件和存儲。
• 具備跨保險庫、文件夾和文件的搜索功能。
• 採用TUS協議進行文件上傳，確保實現可靠且可恢復的文件傳輸。
• 可與Claude Desktop和其他MCP客戶端實現無縫集成。

📦 安裝指南

先決條件 🛠️

在開始安裝之前，請確保您已具備以下條件：

• 擁有Tusky API密鑰（可從您的Tusky賬戶獲取）。
• 安裝了Node.js（版本需為v20或更高）。
• 準備好Claude Desktop或其他MCP客戶端。

安裝步驟 🚀

1. 克隆此倉庫：

git clone https://github.com/superposition/tusky-mcp-server.git
cd tusky-mcp-server

2. 安裝依賴項：

npm install

3. 創建.env文件（從.env.example複製）：

cp .env.example .env

4. 使用您的Tusky API憑證編輯.env文件：

TUSKY_API_KEY=your_api_key_here
TUSKY_API_URL=https://api.tusky.io/v1

5. 構建項目：

npm run build

💻 使用示例

運行服務器 🖥️

啟動服務器

使用以下命令啟動服務器：

npm start

開發模式（自動重新加載）

npm run watch

📚 詳細文檔

Tusky MCP Server 提供了多種工具，可通過兼容的MCP客戶端使用：

• 身份驗證：連接到您的Tusky賬戶。
• 保險庫管理：創建、列出和修改存儲保險庫。
• 文件夾管理：通過文件夾組織內容。
• 文件管理：上傳、下載和管理文件。
• 搜索：在所有保險庫和文件夾中查找內容。查看搜索文檔
• 文件上傳：使用TUS協議進行可靠且可恢復的文件傳輸。查看上傳文檔
• 用戶配置文件：管理您的Tusky配置文件和設置。

與MCP客戶端集成

配置Claude Desktop

macOS系統

# 創建配置文件（如果不存在）
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 使用TextEdit打開配置文件
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows系統

原文檔未給出Windows系統的具體配置命令，可根據實際情況補充。