Mastodon MCP

by The-Focus-AI
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Used for secure credential management to store and retrieve Mastodon API tokens, ensuring secure access to Mastodon accounts without hardcoding credentials.

  • Provides tools for posting content to Mastodon, including creating toots with customizable visibility and content warnings, uploading and attaching media files (images, videos, audio), and adding alt text to media attachments.

マストドンMCP

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

特徴

  • カスタマイズ可能な表示設定とコンテンツ警告付きのトゥートを作成する
  • メディアファイル(画像、動画、音声)をアップロードして添付する
  • メディア添付ファイルに代替テキスト/説明を追加する
  • 1Password CLIを使用した安全な認証情報管理

前提条件

  • 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
  1. ブラウザでhttp://localhost:5173を開きます。
  2. 次のようなパラメータを指定してツールを使用します。
{ "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

-
security - not tested
F
license - not found
-
quality - not tested

Mastodon と対話するためのツールを提供するモデル コンテキスト プロトコル サーバー。ユーザーはカスタマイズ可能な可視性を持つトゥートを作成し、説明付きのメディア ファイルを添付できます。

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Example Usage with MCP Inspector
          2. Development
            1. Security
              1. License
                ID: aa8nqef2kx