Mastodon MCP

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

特征

• 创建具有可自定义可见性和内容警告的嘟文

• 上传并附加媒体文件（图像、视频、音频）

• 为媒体附件添加替代文本/说明

• 使用 1Password CLI 进行安全凭证管理

Related MCP server: MCP Twitter

先决条件

• 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

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 忽略，以防止意外的凭证泄露

执照

国际学习中心