一、用途 ActivityPub MCP Server 是一个轻量级 MCP（Model Context Protocol）服务器，目标是让大语言模型能够探索并与现有的 Fediverse 交互。Fediverse 涵盖 Mastodon、Misskey、Foundkey、Pleroma 及兼容服务器。默认情况下为只读模式，写入工具需手动选择启用。要求 Node.js 20+。
二、主要能力 默认只注册只读工具：发现账号、获取时间线、搜索、获取帖子线程、探索实例、读取趋势内容。由于 MCP 会话中不存在写入工具，注入的 fediverse 内容无法触发账号操作。 公开只读工具（无需账号）：discover-actor、fetch-timeline、get-post-thread、get-instance-info、get-public-timeline、get-trending-hashtags、get-trending-posts、search、discover-instances。 需认证的只读工具（需账号）：list-accounts、switch-account、verify-account、get-home-timeline、get-notifications、get-bookmarks、get-favourites、get-relationship。 启用写入方式：在环境变量或 MCP 配置的 env 块中设置 ACTIVITYPUB_ENABLE_WRITES=true，将注册完整的变更类工具：发帖、回复、删除、转发（boost）、喜欢、收藏、关注、静音、屏蔽、投票、上传媒体以及定时帖子。文档建议启用前先阅读威胁模型。
三、使用方式 一键安装：从最新 release 下载 .mcpb 捆绑包（activitypub-mcp-<version>.mcpb），在 Claude Desktop 中打开。 手动安装：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），然后重启 Claude Desktop。在 Cursor 中编辑 ~/.cursor/mcp.json，然后重启 Cursor。 登录 CLI：通过浏览器运行 OAuth（Mastodon 家族）或 MiAuth（Misskey），凭据保存到 ~/.config/activitypub-mcp/accounts.json。支持多账号，使用 switch-account 切换当前账号。也可通过设置 ACTIVITYPUB_DEFAULT_INSTANCE 和 ACTIVITYPUB_DEFAULT_TOKEN 环境变量免 CLI 流程配置单账号。 添加服务器后可尝试提示词：“Look up @gargron@mastodon.social and summarize their latest posts.” 模型会先调用 discover-actor 获取资料，再用 fetch-timeline 读取近期帖子。examples/ 目录提供可复制配方，包括 Fediverse 研究摘要、定时线程、通知分拣、带替代文本的图片帖以及主题策展。 除默认的 stdio 模式外，服务器还支持 HTTP 模式，提供带 bearer 鉴权的 /mcp 端点与 /health 存活检查，需设置 MCP_HTTP_SECRET（至少 16 字符）启用。自托管为服务时，仓库包含 Dockerfile 和 docker-compose.yml（HTTP 模式）。完整配置见文档：cameronrye.github.io/activitypub-mcp/docs/。
四、平台支持 discover-actor 和 fetch-timeline 使用原生 ActivityPub（WebFinger → actor → outbox），可读取任何符合规范的 ActivityPub 服务器，包括 Mastodon、Misskey、Foundkey、Pleroma/Akkoma、Lemmy（社区和用户）、PeerTube（频道和账号）、GoToSocial 和 Pixelfed。 实例 API 类只读工具（search、get-trending-hashtags、get-trending-posts、get-public-timeline）以及全部写入工具需要 Mastodon 或 Misskey API 实例，因为它们调用这些平台的 REST API。登录使用 OAuth（Mastodon 家族）或 MiAuth（Misskey）。
五、限制与安全 该服务器会抓取可被任意写入的 fediverse 内容（帖子、简介、通知）并输入给 LLM，这些内容可能包含提示注入负载；通知是一个非请求渠道，任何人都可以提及你的账号。<untrusted-content> 包裹与默认只读降低了风险面，但并未消除。完整威胁模型、SSRF 防护、凭据处理与报告说明见 SECURITY.md。
六、许可与致谢 采用 MIT 许可，详见 LICENSE。基于 Anthropic 的 Model Context Protocol 构建，并依照 ActivityPub（W3C）和 ActivityStreams 规范与去中心化社交网络交互。
七、暂未提供的信息 关于定价、收费模式、具体效果指标、性能数据及平台可用范围等，资料中暂未提供。
