Tusky MCP Server 🦣

基本能力

产品定位

Tusky MCP Server 是一个桥梁，连接 Tusky 存储/Mastodon 集成与 AI 助手，通过 MCP 协议实现数据的安全访问和操作。

核心功能

• 认证：与 Tusky API 进行认证
• 文件和文件夹管理：在 Tusky 保险库中管理文件和文件夹
• 用户配置和存储管理：管理用户配置和存储
• 搜索功能：跨保险库、文件夹和文件进行搜索
• 文件上传：使用 TUS 协议进行可靠、可恢复的文件传输
• 无缝集成：与 Claude Desktop 及其他 MCP 客户端无缝集成

适用场景

• 需要将 Tusky 存储与 AI 系统集成的场景
• 需要安全访问和操作 Tusky 数据的场景
• 需要可靠文件上传和管理的场景

工具列表

• 认证工具：连接 Tusky 账户
• 保险库管理工具：创建、列出和修改存储保险库
• 文件夹管理工具：使用文件夹组织内容
• 文件管理工具：上传、下载和管理文件
• 搜索工具：在所有保险库和文件夹中查找内容
• 文件上传工具：使用 TUS 协议上传文件
• 用户配置工具：管理 Tusky 配置和设置

常见问题解答

• 如何获取 Tusky API 密钥？
• 如何配置 MCP 客户端（如 Claude Desktop 或 Cursor）？
• 如何解决文件上传失败的问题？

使用教程

使用依赖

• Tusky API 密钥（从 Tusky 账户获取）
• Node.js（v20 或更高版本）
• MCP 客户端（如 Claude Desktop 或 Cursor）

安装教程

1. 克隆仓库：

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

1. 安装依赖：

npm install

1. 创建 .env 文件：

cp .env.example .env

1. 编辑 .env 文件：

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

1. 构建项目：

npm run build

调试方式

1. 启动服务器：

npm start

1. 开发模式（自动重载）：

npm run watch

1. 配置 MCP 客户端（如 Claude Desktop 或 Cursor）以连接服务器。

许可证

该项目遵循 MIT 开源许可条款。