AI导哈

ActivityPub MCP服务器

一个轻量级的模型上下文协议(MCP)服务器，使LLM能够探索和与现有的Fediverse（如Mastodon、Misskey等）交互，默认只读，写入工具需手动启用。

  • by cameronrye
  • TypeScript
  • 本地部署
  • 17 星标
  • 更新于
在 GitHub 查看 cameronrye/activitypub-mcp

使用说明

ActivityPub MCP Server

Fediverse Client for LLMs

A lightweight Model Context Protocol (MCP) server that lets an LLM explore and interact with the existing Fediverse — Mastodon, Misskey, Foundkey, Pleroma, and compatible servers. Read-only by default; write tools are opt-in.

安装

需要 Node.js 20+.

npx -y activitypub-mcp

一键安装：

克劳德桌面版

单击一下： 下载 .mcpb 捆绑(activitypub-mcp-<version>.mcpb)从 最新版本 并在Claude Desktop中打开它。

手册： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "activitypub": {
      "command": "npx",
      "args": ["-y", "activitypub-mcp"]
    }
  }
}

重新启动克劳德桌面。

光标

编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "activitypub": {
      "command": "npx",
      "args": ["-y", "activitypub-mcp"]
    }
  }
}

重新启动游标。

默认情况下为只读

开箱即用，只有 阅读工具 注册：发现参与者、获取时间线、搜索、获取线程、探索实例、阅读趋势内容。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.

启用写入

集 ACTIVITYPUB_ENABLE_WRITES=true 在环境或MCP配置中 env 块。这注册了全套变异工具：发布、回复、删除、增强、收藏、书签、关注、静音、阻止、投票、上传媒体和计划发布。 阅读 威胁模型 在启用之前。

{
  "mcpServers": {
    "activitypub": {
      "command": "npx",
      "args": ["-y", "activitypub-mcp"],
      "env": {
        "ACTIVITYPUB_ENABLE_WRITES": "true"
      }
    }
  }
}

认证

使用CLI登录：

npx activitypub-mcp login mastodon.social

这将在您的浏览器中运行OAuth（Mastodon家族）或MiAuth（Misskey），并将凭据保存到 ~/.config/activitypub-mcp/accounts.json.支持多帐户--使用 switch-account 更改活动帐户。

或者，设置 ACTIVITYPUB_DEFAULT_INSTANCE 和 ACTIVITYPUB_DEFAULT_TOKEN env变量用于没有CLI流的单个帐户。

平台支持

discover-actor 和 fetch-timeline 直言不讳活动酒吧（WebFinger→ 男演员→ 发件箱），所以他们读 任何 符合ActivityPub标准的服务器——Mastodon、Misskey、Foundkey、Pleroma/Akkoma， 莱米 （社区和用户）， PeerTube （渠道和账户）， GoToSocial，以及 像素化的.

实例-API读取工具(search, get-trending-hashtags, get-trending-posts, get-public-timeline)每个写入工具都需要一个 Mastodon-或Misskey-API 实例，因为它们称这些平台为REST API。登录使用OAuth（Mastodon家族）或MiAuth（Misskey）。

示例

将服务器添加到MCP客户端后，请尝试：

查找gargron@mastodon.social并总结他们的最新帖子。"

模型将调用 discover-actor 要获取配置文件，则 fetch-timeline 阅读最近的帖子。

看 示例/ 用于可复制粘贴的食谱——Fediverse研究摘要、预定线程、通知分类、带alt文本的图像帖子和主题策划。

HTTP传输

除了stdio（默认）之外，服务器还支持承载门控的HTTP模式 /mcp 端点和 /health 活性检查。集 MCP_HTTP_SECRET （最少16个字符）启用。

为了将其作为服务自托管，repo包括 Dockerfile 和一个 docker-compose.yml （HTTP模式）：

export MCP_HTTP_SECRET=$(node -e "console.log(require('crypto').randomBytes(32).toString('hex'))")
docker compose up --build   # then: curl http://localhost:8080/health

请参阅 文档 用于完整配置。

安全

此服务器获取世界可写的fediverse内容（帖子、简历、通知），并将其馈送到LLM。该内容可能包含快速注射有效载荷。通知是一个未经请求的渠道：任何人都可以提及您的帐户。这 <untrusted-content> 信封和只读默认值降低了风险面，但 不要消除它.

看 安全.md 了解完整的威胁模型、SSRF保护、凭证处理和报告说明。

文档

完整的工具参考、资源列表、提示目录、环境变量指南和部署说明在文档网站上发布：

cameronry例如ithub.io/activitypub-mcp/docs/

许可证

麻省理工学院——见 许可证.

致谢

建立在 模型上下文协议 通过Anthropic，并按照指定与去中心化的社交网络进行交互 活动Pub （W3C）和 活动流.

相关 MCP