Freefeed MCP Server

FreeFeed MCP服务器

用于FreeFeed API的MCP服务器，这是一个取代FriendFeed的社交网络。

特性

阅读

• get_timeline -获取用户时间线或主页提要
• get_directs -获取直接（私人）帖子时间线
• get_post -获取带有评论的特定帖子
• get_post_attachments -获取带有URL的附件列表
• search_posts -使用高级运算符搜索帖子
• get_user_profile -获取用户资料信息
• get_user_subscriptions -获取订阅/订阅者
• get_my_groups -获取用户组
• get_group_timeline -获取群组帖子
• get_group_info -获取群组信息

写

• upload_attachment -上传文件（图像、视频等）
• download_attachment -下载帖子附件（尽可能返回图片内容）
• get_attachment_image -下载附件作为带有URL回退的图像内容
• create_direct_post -直接向一个或多个收件人发送帖子
• leave_direct -留下一个直接的帖子
• create_post -创建新帖子（自动上传文件，支持发布到群组）
• update_post -编辑帖子
• delete_post -删除帖子
• like_post / unlike_post -喜欢
• add_comment -添加评论
• update_comment / delete_comment -管理评论
• subscribe_user / unsubscribe_user -订阅/取消订阅

隐私和选择退出

用户可以通过以下方式选择退出AI分析：

1. 在他们的个人资料描述中添加以下标签之一：#noai、#opt-out ai、#no bots、#ai free
2. 将其帐户设置为私人
3. 联系服务器维护人员，将其添加到手动退出列表中

服务器自动排除：

• 私人账户（isPrivate:“1”）
• 已暂停的帐户（isGone:true）
• 在个人资料中带有选择退出标签的用户

默认情况下，选择退出过滤已禁用。通过配置启用它：

• FREEFEED_OPTOUT_ENABLED=true
• FREEFEED_OPTOUT_USERS=oneuser,anotheruser
• FREEFEED_OPTOUT_TAGS=#noai,#opt-out-ai,#no-bots,#ai-free
• FREEFEED_OPTOUT_RESPECT_PRIVATE=true
• FREEFEED_OPTOUT_RESPECT_PAUSED=true
• FREEFEED_OPTOUT_CONFIG=/path/to/opt_out.json

示例退出配置文件：

{
  "enabled": true,
  "manual_opt_out": ["someuser"],
  "tags": ["#noai", "#opt-out-ai", "#no-bots", "#ai-free"],
  "respect_private": true,
  "respect_paused": true
}

安装

1. 安装依赖项：

pip install -e .

1. 创建一个 .env 文件：

FREEFEED_BASE_URL=https://freefeed.net
FREEFEED_API_VERSION=4
FREEFEED_APP_TOKEN=your_app_token
# or
FREEFEED_USERNAME=your_username
FREEFEED_PASSWORD=your_password

用法

启动服务器

python -m freefeed_mcp_server

REST API服务器

# Start HTTP API server
python -m freefeed_mcp_server.api

# Or with uvicorn
uvicorn freefeed_mcp_server.api:app --reload

API将于 http://localhost:8000

📚 API文档：参见 API毫米 🌐 Swagger用户界面: http://localhost:8000/docs

Claude桌面集成

添加到Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "freefeed": {
      "command": "python",
      "args": ["-m", "freefeed_mcp_server"],
      "env": {
        "FREEFEED_BASE_URL": "https://freefeed.net",
        "FREEFEED_API_VERSION": "4",
        "FREEFEED_APP_TOKEN": "your_app_token"
      }
    }
  }
}

Replace `/path/to/venv/bin/python` with your actual virtualenv path. On macOS it is often
`./.venv/bin/python` if you created a local venv in the project directory.

Claude桌面集成（系统Python）

使用系统Python可执行文件：

{
  "mcpServers": {
    "freefeed": {
      "command": "/usr/bin/python3",
      "args": ["-m", "freefeed_mcp_server"],
      "env": {
        "FREEFEED_BASE_URL": "https://freefeed.net",
        "FREEFEED_API_VERSION": "4",
        "FREEFEED_APP_TOKEN": "your_app_token"
      }
    }
  }
}

Claude桌面集成（virtualenv）

使用virtualenv中的Python可执行文件：

{
  "mcpServers": {
    "freefeed": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "freefeed_mcp_server"],
      "env": {
        "FREEFEED_BASE_URL": "https://freefeed.net",
        "FREEFEED_API_VERSION": "4",
        "FREEFEED_APP_TOKEN": "your_app_token"
      }
    }
  }
}

### MCP tool examples

{ "name": "get_directs", "arguments": { "limit": 20 } }

{ "name": "create_direct_post", "arguments": { "body": "Hi from MCP!", "recipients": ["alice", "bob"] } }

{ "name": "leave_direct", "arguments": { "post_id": "POST_ID" } }

{ "name": "get_attachment_image", "arguments": { "attachment_url": "https://freefeed.net/attachments/ATTACHMENT_ID", "max_bytes": 2000000 } }

{ "name": "download_attachment", "arguments": { "attachment_url": "https://freefeed.net/attachments/ATTACHMENT_ID", "prefer_image": true, "max_bytes": 2000000 } }

Request examples

Get home feed

{
  "name": "get_timeline",
  "arguments": {
    "timeline_type": "home"
  }
}

搜索帖子

{
  "name": "search_posts",
  "arguments": {
    "query": "intitle:MCP from:username"
  }
}

创建帖子

{
  "name": "create_post",
  "arguments": {
    "body": "Testing the FreeFeed MCP server!"
  }
}

创建带有图像的帖子

{
  "name": "create_post",
  "arguments": {
    "body": "Check out this photo!",
    "attachment_paths": ["/path/to/image.jpg"]
  }
}

在群中创建帖子

{
  "name": "create_post",
  "arguments": {
    "body": "A post for my group!",
    "group_names": ["mygroup"]
  }
}

获取群组帖子

{
  "name": "get_group_timeline",
  "arguments": {
    "group_name": "mygroup",
    "limit": 20
  }
}

获取帖子附件并下载

{
  "name": "get_post_attachments",
  "arguments": {
    "post_id": "post-id-here"
  }
}

然后下载：

{
  "name": "download_attachment",
  "arguments": {
    "attachment_url": "https://freefeed.net/attachments/att-id",
    "save_path": "/path/to/save/image.jpg"
  }
}

FreeFeed API

API文件：https://github.com/FreeFeed/freefeed-server/wiki/API

支持的搜索运算符：

• intitle:query -在帖子正文中搜索
• incomment:query -在评论中搜索
• from:username -按作者搜索
• AND, OR -逻辑运算符

许可证

麻省理工学院