tusky-mcp-server

tusky-mcp-server

0

Tusky MCP Server acts as a bridge integrating Tusky storage with AI assistants like Claude, using the Model Context Protocol to manage files, folders, and user profiles securely. It ensures seamless development and deployment with key features like file uploads, search functionality, and secure API authentication.

Overview

Tusky MCP Server is a Model Context Protocol (MCP) server designed to integrate Tusky storage and Mastodon with AI systems like Claude. It provides API authentication, file and folder management in Tusky vaults, user profile management, and search functionality. Reliable file uploads are ensured through the TUS protocol, enhancing integration with MCP clients like Claude Desktop.

Features

  • Authentication with Tusky API
  • Management of files, folders, and user profiles in Tusky
  • Search across vaults and files
  • Seamless Claude Desktop integration

Prerequisites

  • Tusky API key
  • Node.js v20+
  • MCP client (Claude Desktop or Cursor)

Installation

  • Clone repository
  • Install dependencies
  • Configure environment variables
  • Build the project

Running the Server

  • Use npm start to start server
  • npm run watch for development mode

Development Roadmap

  • Foundation, authentication, core listing and retrieval, advanced features including error handling and tests

Contributing

Guidelines are available for interested contributors. Licensed under MIT.