マストドンMCP

Mastodon と連携するためのツールを提供するモデルコンテキストプロトコルサーバー。現在、オプションのメディア添付ファイル付きのトゥートの作成をサポートしています。

特徴

• カスタマイズ可能な表示設定とコンテンツ警告付きのトゥートを作成する

• メディアファイル（画像、動画、音声）をアップロードして添付する

• メディア添付ファイルに代替テキスト/説明を追加する

• 1Password CLIを使用した安全な認証情報管理

Related MCP server: MCP Twitter

前提条件

• Node.js 18歳以上

• pnpm

• 1Password CLI ( op ) のインストールと設定

• MastodonアカウントとAPIアクセストークン

インストール

# Clone the repository
git clone [repository-url]
cd mastodon-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

構成

このツールを使用するには、1Password に保存されている Mastodon API トークンが必要です。トークンは以下の場所に保管してください。

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

オプションで、環境変数を使用して Mastodon インスタンスの URL を設定することもできます。

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

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

使用法

MCP サーバーを起動します。

pnpm start

サーバーは、次のパラメータを持つ単一のツールmastodon_create_toot公開します。

• content （必須）: トゥートのテキストコンテンツ

• visibility : 「公開」、「非公開」、「非公開」、「直接」のいずれか (デフォルト: 「公開」)

• sensitive : センシティブなコンテンツのブールフラグ（デフォルト: false）

• spoiler_text : コンテンツの前に表示される警告テキスト（デフォルト: ""）

• media_file : 添付するメディアファイルへのパス

• media_description : 添付メディアの代替テキスト/説明

MCP Inspectorの使用例

1. インスペクターを起動します。

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

2. ブラウザでhttp://localhost:5173を開きます。

3. 次のようなパラメータを指定してツールを使用します。

{
  "content": "Hello from MCP!",
  "visibility": "public",
  "media_file": "/path/to/image.jpg",
  "media_description": "A beautiful sunset"
}

発達

# Run in development mode with auto-reloading
pnpm dev

# Build the project
pnpm build

# Run the built server
pnpm start

安全

• コードベースに資格情報がハードコードされていない

• APIトークンは1Passwordに安全に保存され、そこから取得されます

• APIレスポンスは、認証情報の偶発的な漏洩を防ぐためにgit-ignoreされます。

ライセンス

ISC