Mastodon MCP

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

功能

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

前提条件

• Node.js 18+
• pnpm
• 已安装并配置的 1Password CLI (op)
• 一个 Mastodon 帐户和 API 访问令牌

安装

# 克隆仓库
git clone [repository-url]
cd mastodon-mcp

# 安装依赖
pnpm install

# 构建项目
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. 启动 inspector：

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"
}

开发

# 以自动重新加载的开发模式运行
pnpm dev

# 构建项目
pnpm build

# 运行构建的服务器
pnpm start

安全

• 代码库中没有硬编码的凭据
• API 令牌安全地存储在 1Password 中并从中检索
• API 响应被 git-ignore，以防止意外的凭据泄露

许可证

ISC