项目介绍
ActivityPub MCP Server - Fediverse 客户端

一个全面的**模型上下文协议(MCP)**服务器,使像Claude这样的大型语言模型能够通过标准化的MCP工具、资源和提示与现有的Fediverse进行交互。
<!-- 触发CI -->

功能
核心能力
- Fediverse 客户端:与现有的ActivityPub服务器(如Mastodon、Pleroma、Misskey等)进行交互。
- WebFinger 发现:在Fediverse中查找和发现用户。
- MCP 协议:完整的MCP服务器,包括资源、工具和提示。
- LLM优化:专门设计用于大型语言模型的交互模式。
- TypeScript:使用现代TypeScript和ESM完全类型化。
- 高性能:高效的资源管理和缓存。
- 安全:内置的安全特性及输入验证。
Fediverse 交互功能
- 远程用户发现:查找任何Fediverse实例上的用户。
- 时间线获取:获取任何用户的帖子。
- 实例发现:查找并探索Fediverse实例。
- 实例信息:获取任何服务器的详细信息。
- 搜索功能:跨实例搜索内容。
- WebFinger 支持:解析网络中的用户标识符。
- 多平台支持:适用于Mastodon、Pleroma、Misskey等。
- 关注者/关注列表:访问社交连接。
MCP 功能
- 资源:访问远程ActivityPub数据(用户、时间线、实例信息)。
- 工具:发现和与Fediverse内容互动。
- 提示:模板用于探索和发现Fediverse。
- 监控:内置的日志和性能指标。
- 健康检查:服务器健康监控和诊断。
快速开始
先决条件
- Node.js 18+(推荐长期支持版本)
- npm 或 yarn 包管理器
- Git 用于克隆仓库
跨平台支持
此项目在Windows、macOS 和 Linux 上运行,并自动检测平台并选择适当的脚本。
一键安装
为了最快的设置,请使用我们的自动化安装脚本:
普通(所有平台)
# 使用npx直接安装(推荐)
npx activitypub-mcp install
# 或克隆并运行设置
git clone https://github.com/cameronrye/activitypub-mcp.git
cd activitypub-mcp
npm run setup
平台特定安装
Windows (PowerShell):
# 克隆并设置
git clone https://github.com/cameronrye/activitypub-mcp.git
cd activitypub-mcp
npm run setup:windows
# 或直接运行PowerShell脚本
.\scripts\setup.ps1
macOS/Linux (Bash):
# 克隆并设置
git clone https://github.com/cameronrye/activitypub-mcp.git
cd activity
由于篇幅限制,剩余部分将在下一条消息中继续翻译。