Mastodon

🚀 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 許可證。