Mastodon MCP
提供与 Mastodon 交互工具的模型上下文协议服务器。目前支持创建带有可选媒体附件的 toot。
特征
- 创建具有可自定义可见性和内容警告的嘟文
- 上传并附加媒体文件(图像、视频、音频)
- 为媒体附件添加替代文本/说明
- 使用 1Password CLI 进行安全凭证管理
先决条件
- Node.js 18+
- 下午
- 1Password CLI(
op
)已安装并配置 - Mastodon 帐户和 API 访问令牌
安装
# Clone the repository
git clone [repository-url]
cd mastodon-mcp
# Install dependencies
pnpm install
# Build the project
pnpm build
配置
该工具需要存储在 1Password 中的 Mastodon API 令牌。请将您的令牌存储在:
op://Personal/Floss.Social Key/notesPlain
您可以选择通过环境变量设置 Mastodon 实例 URL:
export MASTODON_INSTANCE_URL="https://your.instance.social"
如果未设置,则默认为https://floss.social
。
用法
启动 MCP 服务器:
服务器公开一个具有以下参数的单一工具mastodon_create_toot
:
content
(必填):您的嘟文内容visibility
:"public"、"unlisted"、"private" 或 "direct" 之一(默认值:"public")sensitive
:敏感内容的布尔标志(默认值:false)spoiler_text
:内容前显示的警告文本(默认值:“”)media_file
:要附加的媒体文件的路径media_description
:附加媒体的替代文本/描述
MCP Inspector 的使用示例
- 启动检查器:
npx @modelcontextprotocol/inspector node dist/mcp-server.js
- 在浏览器中打开http://localhost:5173
- 使用该工具的参数如下:
{
"content": "Hello from MCP!",
"visibility": "public",
"media_file": "/path/to/image.jpg",
"media_description": "A beautiful sunset"
}
发展
# Run in development mode with auto-reloading
pnpm dev
# Build the project
pnpm build
# Run the built server
pnpm start
安全
- 代码库中没有硬编码凭证
- API 令牌安全地存储在 1Password 中并从中检索
- API 响应被 git 忽略,以防止意外的凭证泄露
执照
国际学习中心