Tusky MCP Server

🚀 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

1. Clone this repository:

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

2. Install the dependencies:

npm install

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

cp .env.example .env

4. Edit the .env file with your Tusky API credentials:

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

5. 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.