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系统的具体配置命令，可根据实际情况补充。