Mastodon MCP
2025.03.21
0
TypeScript社交网络工具Mastodon 集成交流协作
Mastodon MCP 是一个基于 Model Context Protocol 的服务器，专门用于与 Mastodon 社交网络平台进行交互。它支持创建带有可选媒体附件的 toots（Mastodon 的帖子），并提供了丰富的功能来管理帖子的可见性和内容警告。
View on GitHub
Overview
基本能力
产品定位
Mastodon MCP 是一个专门为 Mastodon 社交网络平台设计的工具服务器，旨在简化与 Mastodon API 的交互，特别是创建和管理 toots。
核心功能
- 创建带有自定义可见性和内容警告的 toots
- 上传并附加媒体文件（图片、视频、音频）
- 为媒体附件添加替代文本/描述
- 使用 1Password CLI 进行安全的凭证管理
适用场景
- 自动化社交网络帖子发布
- 批量管理 Mastodon 内容
- 集成到其他应用中实现社交网络功能
工具列表
mastodon_create_toot: 用于创建 Mastodon toot，支持内容、可见性、敏感内容标志、警告文本、媒体文件和媒体描述等参数。
常见问题解答
- 如何存储 Mastodon API 令牌？
令牌应存储在 1Password 中，路径为
op://Personal/Floss.Social Key/notesPlain。 - 如何设置 Mastodon 实例 URL？
可以通过环境变量
MASTODON_INSTANCE_URL设置，默认为https://floss.social。
使用教程
使用依赖
- Node.js 18+
- pnpm
- 1Password CLI (
op) 已安装并配置 - Mastodon 账户和 API 访问令牌
安装教程
# 克隆仓库
git clone [repository-url]
cd mastodon-mcp
# 安装依赖
pnpm install
# 构建项目
pnpm build
调试方式
# 启动 MCP 服务器
pnpm start
# 使用 MCP Inspector 进行调试
npx @modelcontextprotocol/inspector node dist/mcp-server.js
打开浏览器访问 http://localhost:5173 使用工具。