Mastodon

🚀 Mastodon MCP サーバー

Model Context Protocol サーバーで、Mastodon とのやり取りを可能にするツールを提供します。現在は、オプションでメディア添付を含む投稿の作成をサポートしています。

✨ 主な機能

• カスタム可視性とコンテンツ警告を持つ投稿の作成
• メディアファイル（画像、動画、音声）のアップロードと添付
• メディア添付の alt テキスト/説明の追加
• 1Password CLI を使用した安全な認証情報管理

📦 インストール

前提条件

• Node.js バージョン 18 以上
• pnpm ツール
• 1Password CLI (op) のインストールと設定完了
• Mastodon アカウントと API アクセストークンの所有

インストール手順

# リポジトリをクローン
git clone [repository-url]
cd mastodon-mcp

# 依存関係をインストール
pnpm install

# プロジェクトをビルド
pnpm build

🛠️ 設定

このツールでは、Mastodon API トークンを 1Password に保存する必要があります。トークンを以下に保存してください：

• op://Personal/Floss.Social Key/notesPlain

また、環境変数を使用して Mastodon インスタンスの URL を設定することもできます：

export MASTODON_INSTANCE_URL="https://your.instance.social"

設定されていない場合は、デフォルトで https://floss.social が使用されます。

💻 使用例

サーバーの起動

pnpm start

このサーバーは、以下のパラメータを持つ mastodon_create_toot ツールを提供します：

• content（必須）：投稿のテキスト内容
• visibility："public"、"unlisted"、"private"、または "direct" のいずれか（デフォルト："public"）
• sensitive：敏感な内容をマークするブールフラグ（デフォルト：false）
• spoiler_text：内容の前に表示されるテキスト警告（デフォルト：""）
• media_file：添付するメディアファイルのパス
• media_description：添付メディアの alt テキスト/説明

MCP チェッカーの使用例

1. チェッカーを起動します：

npx @modelcontextprotocol/inspector node dist/mcp-server.js

2. ブラウザで http://localhost:5173 を開きます。
3. 次のようなパラメータを使用してツールを使用します：

{
  "content": "来自 MCP 的问候！",
  "visibility": "public",
  "media_file": "/path/to/image.jpg",
  "media_description": "美丽的日落"
}

開発

# 自動リロード付きで開発モードで実行
pnpm dev

# プロジェクトをビルド
pnpm build

# ビルド後のサーバーを実行
pnpm start

セキュリティ

• コードベースにはハードコードされた認証情報がありません。
• API トークンは安全に保存され、1Password から取得されます。
• API レスポンスは、意図しない認証情報の漏洩を防ぐために git で無視されます。

📄 ライセンス

ISC