Tusky MCP Server

Tusky MCP Server is a bridge server connecting Tusky storage/Mastodon integration with AI assistants, enabling AI systems such as Claude to securely access and operate data in Tusky through the Model Context Protocol. It provides functions such as authentication, storage management, file operations, search, and TUS - protocol uploads.

Cloud storage Knowledge management and memory #Storage Integration #AI Bridge #File Management #Protocol Service Local .TypeScript

rating : 2 points

downloads : 12

update time : 2025-04-28

What is Tusky MCP Server?

Tusky MCP Server is a bridge connecting Tusky storage and AI assistants (such as Claude), enabling secure access to and operation of data through standard interfaces.

How to use Tusky MCP Server?

You can enable this service through simple installation and configuration steps, and then operate it using a compatible AI client.

Applicable Scenarios

Suitable for users who need to integrate an AI assistant with personal data storage, such as note - organizing and file - management.

Main Features

AuthenticationVerify your Tusky account via an API key.

Vault ManagementCreate, list, and modify vaults in Tusky storage.

Folder ManagementOrganize content and create new folders.

File ManagementUpload, download, and delete files.

Search FunctionSearch for content across all vaults and folders.

Reliable UploadUse the TUS protocol to upload large files, supporting resumable uploads.

Advantages and Limitations

Advantages

Supports integration with multiple AI assistants

High - security to protect user data

Easy to configure and use

Limitations

Requires a certain technical foundation to complete the initial setup

Limited to AI assistants compatible with MCP

How to Use

Clone the Repository

Clone the code of Tusky MCP Server from GitHub.

Install Dependencies

Install the required Node.js dependencies.

Configure Environment Variables

Edit the.env file and add your Tusky API credentials.

Start the Service

Run the built script to start the server.

Usage Examples

Search for Files by KeywordsFind files containing specific keywords.

Upload Large FilesUpload large files over 1GB to Tusky storage.

Frequently Asked Questions

How to configure Claude Desktop?

Does it support multi - user collaboration?

How to solve the problem of failed uploads?

Related Resources

Official Documentation

Learn about the detailed introduction of the Model Context Protocol.

Tusky API Documentation

Explore the functions and usage of the Tusky API.

GitHub Repository

Get the source code and the latest updates.

🚀 Tusky MCP Server

A Model Context Protocol (MCP) server for integrating Tusky with Claude and other MCP-compatible AI systems.

🚀 Quick Start

Tusky MCP Server serves as a bridge between Tusky storage/Mastodon integration and AI assistants using the Model Context Protocol (MCP). This enables Claude and other compatible AIs to securely access and manipulate data in Tusky through a standard interface.

✨ Features

Authentication using the Tusky API.
Management of files and folders in Tusky vaults.
User profile and storage management.
Search functionality across vaults, folders, and files.
File uploads using the TUS protocol for reliable and resumable file transfer.
Seamless integration with Claude Desktop and other MCP clients.

🛠️ Prerequisites

Before you start, make sure you have:

A Tusky API key (obtained from your Tusky account).
Node.js (version 20 or higher).
Claude Desktop or other MCP clients.

📦 Installation

Clone this repository:

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

Install the dependencies:

npm install

Create a .env file (copy from .env.example):

cp .env.example .env

Edit the .env file with your Tusky API credentials:

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

Build the project:

npm run build

💻 Usage Examples

Basic Usage

Start the server using the following command:

npm start

Advanced Usage

For development with automatic reloading:

npm run watch

📚 Documentation

Tusky MCP Server provides various tools that can be used through compatible MCP clients:

Authentication: Connect to your Tusky account.
Vault management: Create, list, and modify storage vaults.
Folder management: Organize content by folders.
File management: Upload, download, and manage files.
Search: Find content across all vaults and folders. View search documentation.
File uploads: Use the TUS protocol for reliable and resumable file transfer. View upload documentation.
User profile: Manage your Tusky profile and settings.

Integrating with MCP Clients

Configuring Claude Desktop

For macOS:

# Create the configuration file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Open the configuration file using TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

For Windows:

# The original README didn't provide Windows-specific commands. You may need to add relevant content here.

Featured MCP Services

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

572

5 points

Figma Context MCP

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

TypeScript

5.2K

4.7 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご