🚀 Mastodon MCP 服务器

Mastodon MCP 服务器是一个基于 Model Context Protocol 的服务器，它提供了与 Mastodon 交互的实用工具。目前，该服务器支持创建带可选媒体附件的帖子，为用户提供了便捷的内容发布方式。

🚀 快速开始

Mastodon MCP 服务器能让你轻松与 Mastodon 进行交互。在使用前，请确保满足先决条件，并完成安装和配置步骤。

✨ 主要特性

• 自定义帖子发布：可创建具有自定义可见性和内容警告的帖子，满足不同的发布需求。
• 媒体文件支持：支持上传并附加图片、视频、音频等媒体文件，丰富帖子内容。
• 媒体描述添加：能为媒体附件添加 alt 文本或描述，提升内容的可访问性。
• 安全凭证管理：使用 1Password CLI 进行安全的凭证管理，保障信息安全。

📦 安装指南

先决条件

• 安装 Node.js 18+ 版本。
• 安装 pnpm 工具。
• 安装并配置 1Password CLI (op)。
• 拥有一个 Mastodon 账户及 API 访问令牌。

安装步骤

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

# 安装依赖项
pnpm install

# 构建项目
pnpm build

📚 详细文档

配置

该工具需要将 Mastodon API 令牌存储在 1Password 中，存储路径为：

• 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 工具带有以下参数：

使用 MCP 检查器的示例用法

1. 启动检查器：

npx @modelcontextprotocol/inspector node dist/mcp-server.js

2. 在浏览器中打开 http://localhost:5173。
3. 使用类似以下参数的工具：

{
  "content": "来自 MCP 的问候！",
  "visibility": "public",
  "media_file": "/path/to/image.jpg",
  "media_description": "美丽的日落"
}

开发

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

# 构建项目
pnpm build

# 运行构建后的服务器
pnpm start

安全

• 代码库中没有硬编码凭证，保障凭证安全。
• API 令牌安全地存储并从 1Password 中检索。
• API 响应被 git 忽略，防止意外凭证泄露。

📄 许可证

本项目采用 ISC 许可证。