Mastodon MCP

一个Model Context Protocol服务器，提供与Mastodon互动的工具。当前支持创建带有可选媒体附件的推文。

功能

• 创建具有自定义可见性和内容警告的推文
• 上传并附加媒体文件（图片、视频、音频）
• 为媒体附件添加替代文本/描述
• 安排未来的推文时间
• 使用环境变量或1Password CLI进行安全凭证管理

预备条件

• Node.js 18+
• pnpm
• 一个Mastodon账户和API访问令牌
• 可选地，安装并配置1Password CLI（op），如果使用1Password进行凭证管理。

安装

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

# 安装依赖
pnpm install

# 构建项目
pnpm build

配置

该工具需要一个Mastodon API令牌。你可以通过以下方式之一提供此令牌：

1. 环境变量（推荐用于简单性）： 设置MASTODON_ACCESS_TOKEN环境变量：

   export MASTODON_ACCESS_TOKEN="your_mastodon_api_token"
   

2. 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：敏感内容的布尔标志（默认：false）
• spoiler_text：显示在内容之前的警告文本（默认：""）
• media_file：要附加的媒体文件路径
• media_description：附加媒体的替代文本/描述
• scheduled_at：可选的ISO 8601日期时间，用于安排未来的推文时间（例如："2_024-07-04T10:00:00-07:00"）

使用MCP Inspector示例

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": "美丽的日落",
  "scheduled_at": "2025-01-01T12:00:00Z"
}

开发

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

# 构建项目
pnpm build

# 运行构建的服务器
pnpm start

安全

• 不在代码库中硬编码任何凭证
• API令牌可以通过环境变量安全管理，或者从1Password检索。
• API响应被git忽略，以防意外泄露凭证

许可证

ISC