🚀 Mastodon MCP 服务器
Mastodon MCP 服务器是一个基于 模型上下文协议 的服务器，为与 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，其参数如下：
content（必需）：帖子的文本内容visibility：可选值为 "public"、"unlisted"、"private" 或 "direct"，默认值为 "public"sensitive：敏感内容的布尔标志，默认值为 falsespoiler_text：显示在内容之前的警告文字，默认值为空字符串media_file：要附加的媒体文件路径media_description：附件媒体的 alt 文本/描述
示例：使用 MCP 检查器
- 启动检查器：
npx @modelcontextprotocol/inspector node dist/mcp-server.js
- 在浏览器中打开 http://localhost:5173。
- 使用以下参数与工具交互：
{
"content": "来自 MCP 的你好！",
"visibility": "public",
"media_file": "/path/to/image.jpg",
"media_description": "一个美丽的日落"
}
开发
# 以开发模式运行，带有自动重新加载
pnpm dev
# 构建项目
pnpm build
# 运行构建后的服务器
pnpm start
安全性
- 代码中未硬编码任何凭证。
- API 令牌安全地存储在 1Password 中，并从中检索。
- API 响应被 git 忽略，可防止意外的凭证泄露。
📄 许可证
本项目采用 ISC 许可证。