Tusky MCP Server 🦣
About
An empty MCP server for Tusky/Mastodon integration
Details
- License
- MIT license
Explore
- 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
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
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
Start the server with:
npm start
For development with auto-reload:
npm run watch
For macOS:
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
For Windows:
code %APPDATA%\Claude\claude_desktop_config.json
Add your server configuration:
{
"mcpServers": {
"tusky-mcp": {
"command": "node",
"args": ["/path/to/your/build/index.js"],
"env": {
"TUSKY_API_KEY": "your-api-key-here",
"TUSKY_API_URL": "https://api.tusky.io/v1"
}
}
}
}
1. Open Cursor Settings
2. Navigate to Features > MCP Servers
3. Click on the "+ Add New MCP Server" button
4. Fill out the following information:
- Name: Enter a nickname for the server (e.g., "tusky-mcp")
- Type: Select "command" as the type
- Command: Enter the command to run the server:
env TUSKY_API_KEY=your-api-key TUSKY_API_URL=https://api.tusky.io/v1 node /path/to/your/build/index.js
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
