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.

Mastodon MCP

提供与 Mastodon 交互工具的模型上下文协议服务器。目前支持创建带有可选媒体附件的 toot。

特征

  • 创建具有可自定义可见性和内容警告的嘟文
  • 上传并附加媒体文件(图像、视频、音频)
  • 为媒体附件添加替代文本/说明
  • 使用 1Password CLI 进行安全凭证管理

先决条件

  • Node.js 18+
  • 下午
  • 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 :"public"、"unlisted"、"private" 或 "direct" 之一(默认值:"public")
  • 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 忽略,以防止意外的凭证泄露

执照

国际学习中心

-
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