Tusky MCP Server 🦣

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

What is Tusky MCP Server?

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

Features

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

Prerequisites 🛠

Before you begin, ensure you have:

- A Tusky API key (obtained from your Tusky account)
- Node.js (v20 or higher)
- An MCP client like Claude Desktop or Cursor

Installation 🚀

1. Clone this repository:

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

cd tusky-mcp-server

2. Install dependencies:

npm install

3. Create a .env file (copying 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

Running the Server 🖥️

Start the server with:

npm start

For development with auto-reload:

npm run watch

Feature Documentation

The Tusky MCP Server provides several 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 your content with folders
- File Management: Upload, download, and manage files
- Search: Find content across all your vaults and folders. See search documentation
- File Uploads: Upload files using the TUS protocol for reliable and resumable file transfers. See upload documentation
- User Profile: Manage your Tusky profile and settings

Integrating with MCP Clients

Configuring Claude Desktop

For macOS:

```shell