Tusky MCP Server 🦣

Tusky MCP Server 🦣

Tusky を Claude やその他の MCP 互換 AI システムと統合するための Model Context Protocol（MCP）サーバーです。

Tusky MCP Server とは？

Tusky MCP Server は、Tusky のストレージ／Mastodon 統合機能と、Model Context Protocol（MCP）を使用する AI アシスタントとの間をつなぎます。これにより、Claude やその他の互換性のある AI が、標準化されたインターフェースを通じて Tusky のデータに安全にアクセスし、操作できるようになります。

機能

• Tusky API による認証
• Tusky ボールト内のファイルとフォルダーの管理
• ユーザープロフィールとストレージの管理
• ボールト、フォルダー、ファイルを横断した検索機能
• 信頼性の高い再開可能なファイル転送を実現する、TUS プロトコルを使用したファイルアップロード
• Claude Desktop やその他の MCP クライアントとのシームレスな統合

前提条件 🛠

開始する前に、以下をご用意ください。

• Tusky API キー（Tusky アカウントから取得）
• Node.js（v20 以降）
• Claude Desktop や Cursor などの MCP クライアント

インストール 🚀

1. このリポジトリをクローンします。

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

2. 依存関係をインストールします。

npm install

3. .env.example をコピーして .env ファイルを作成します。

cp .env.example .env

4. Tusky API の認証情報を使って .env ファイルを編集します。

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

5. プロジェクトをビルドします。

npm run build

サーバーの実行 🖥️

次のコマンドでサーバーを起動します。

npm start

自動リロードを有効にして開発する場合：

npm run watch

機能のドキュメント

Tusky MCP Server には、互換性のある MCP クライアントから利用できるツールがいくつか用意されています。

• 認証：Tusky アカウントに接続します
• ボールト管理：ストレージボールトの作成、一覧表示、変更を行います
• フォルダー管理：フォルダーを使ってコンテンツを整理します
• ファイル管理：ファイルのアップロード、ダウンロード、管理を行います
• 検索：すべてのボールトとフォルダーからコンテンツを検索します。検索ドキュメントを見る
• ファイルアップロード：信頼性の高い再開可能なファイル転送を実現するため、TUS プロトコルを使ってファイルをアップロードします。アップロードドキュメントを見る
• ユーザープロフィール：Tusky のプロフィールと設定を管理します

MCP クライアントとの統合

Claude Desktop の設定

macOS の場合：

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

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

Windows の場合：

code %APPDATA%\Claude\claude_desktop_config.json

サーバー設定を追加します。

{
  "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"
      }
    }
  }
}

Cursor の設定

1. Cursor の設定を開きます
2. 「Features」>「MCP Servers」に移動します
3. 「+ Add New MCP Server」ボタンをクリックします
4. 以下の情報を入力します。
   • 名前：サーバーのニックネーム（例：「tusky-mcp」）を入力します
   • 種類：種類として「command」を選択します
   • コマンド：サーバーを実行するコマンドを入力します。

     env TUSKY_API_KEY=your-api-key TUSKY_API_URL=https://api.tusky.io/v1 node /path/to/your/build/index.js
     

開発ロードマップ

開発は以下の段階に分かれています。

1. Tier 1 - 基盤：基本的な MCP サーバー構成
2. Tier 2 - 認証：認証チャレンジと API キー管理
3. Tier 3 - コアの一覧表示／取得：ボールトとフォルダーの一覧表示
4. Tier 4 - コアの作成／変更：ボールト、フォルダー、ファイルの作成と変更
5. Tier 5 - 高度な機能：ファイルアップロード、ボールト共有、検索機能
6. Tier 6 - インフラストラクチャ：エラー処理、レスポンスのフォーマット、テスト

詳細なタスクの内訳については、「Issues」タブをご覧ください。

貢献

Tusky MCP Server への貢献を歓迎します。詳しくは、貢献ガイドラインをご覧ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

謝辞 🙏

• MCP 仕様を提供するModel Context Protocol
• Claude Desktop を提供する Anthropic
• 素晴らしいストレージおよび Mastodon 統合プラットフォームを提供する Tusky チーム