Back to MCP directory
publicPublicdnsLocal runtime

tusky-mcp-server

Tusky MCP Server是一个连接Tusky存储/Mastodon集成与AI助手的桥梁服务器,通过Model Context Protocol协议让Claude等AI系统安全访问和操作Tusky中的数据。提供认证、存储管理、文件操作、搜索和TUS协议上传等功能。

article

README

🚀 用于将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
  1. 安装依赖项:
npm install
  1. 创建.env文件(从.env.example复制):
cp .env.example .env
  1. 使用您的Tusky API凭证编辑.env文件:
TUSKY_API_KEY=your_api_key_here
TUSKY_API_URL=https://api.tusky.io/v1
  1. 构建项目:
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系统的具体配置命令,可根据实际情况补充。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client