BuddyPress MCP Server

BuddyPress MCP服务器

模型上下文协议（MCP）服务器，提供与BuddyPress REST API v2的全面集成。该服务器使Claude等人工智能助手能够与BuddyPress网站进行交互，管理活动、成员、组、个人资料、消息等。

特性

活动管理

• 列出、创建、更新和删除活动项
• 喜欢/不喜欢的活动
• 按用户、组、范围和搜索词筛选

会员管理

• 列出和搜索成员
• 获取会员资料
• 更新会员信息
• 删除成员

组管理

• 列出、创建、更新和删除组
• 管理组成员资格
• 处理群组邀请和会员请求
• 按状态、类型和用户筛选组

XProfile（扩展配置文件）

• 列出配置文件字段组和字段
• 获取和更新用户配置文件数据
• 管理自定义配置文件字段

朋友和社交

• 列出友谊
• 创建和管理好友请求
• 删除友谊

消息

• 列出消息线程
• 发送新消息
• 管理对话
• 按收件箱/发送框筛选

通知

• 列出用户通知
• 将通知标记为已读/未读
• 删除通知

组件

• 列出活动BuddyPress组件

安装

1. 克隆或创建目录：

   mkdir buddypress-mcp
   cd buddypress-mcp

1. 安装依赖项：

   npm install

1. 构建TypeScript代码：

   npm run build

配置

设置以下环境变量：

export BUDDYPRESS_URL="http://yourdomain.com"
export BUDDYPRESS_USERNAME="your-username"
export BUDDYPRESS_PASSWORD="your-application-password"

创建应用程序密码

对于WordPress/BudyPress身份验证：

1. 转到您的WordPress管理仪表板
2. 导航到用户→ 个人资料
3. 滚动到“应用程序密码”部分
4. 创建新的应用程序密码
5. 使用此密码（不是常规密码）进行身份验证

使用Claude Desktop

将此配置添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "buddypress": {
      "command": "node",
      "args": [
        "/path/to/buddypress-mcp/dist/index.js"
      ],
      "env": {
        "BUDDYPRESS_URL": "http://buddypress.local",
        "BUDDYPRESS_USERNAME": "admin",
        "BUDDYPRESS_PASSWORD": "your-application-password"
      }
    }
  }
}

添加配置后，重新启动Claude Desktop。

可用工具

活动工具

• buddypress_list_activities -列出活动流项目
• buddypress_get_activity -获得单一活动
• buddypress_create_activity -创建新活动
• buddypress_update_activity -更新活动
• buddypress_delete_activity -删除活动
• buddypress_favorite_activity -最喜欢/不喜欢的活动

成员工具

• buddypress_list_members -列出成员
• buddypress_get_member -获取单个成员
• buddypress_update_member -更新会员资料
• buddypress_delete_member -删除成员

组工具

• buddypress_list_groups -列出组
• buddypress_get_group -获取单个组
• buddypress_create_group -创建新组
• buddypress_update_group -更新组
• buddypress_delete_group -删除组
• buddypress_list_group_members -列出组成员
• buddypress_add_group_member -将成员添加到组
• buddypress_remove_group_member -从组中删除成员

XProfile工具

• buddypress_list_xprofile_groups -列出字段组
• buddypress_get_xprofile_group -获取字段组
• buddypress_list_xprofile_fields -列出配置文件字段
• buddypress_get_xprofile_field -获取配置文件字段
• buddypress_get_xprofile_data -获取用户配置文件数据
• buddypress_update_xprofile_data -更新用户配置文件数据

好友工具

• buddypress_list_friends -列出友谊
• buddypress_create_friendship -创建好友请求
• buddypress_delete_friendship -删除友谊

消息工具

• buddypress_list_messages -列出消息线程
• buddypress_get_message -获取消息线程
• buddypress_create_message -发送新消息
• buddypress_delete_message -删除消息线程

通知工具

• buddypress_list_notifications -列出通知
• buddypress_get_notification -获取单个通知
• buddypress_update_notification -更新通知状态
• buddypress_delete_notification -删除通知

组件工具

• buddypress_list_components -列出活动组件

WordPress能力API工具

• wordpress_list_abilities -列出已注册的WordPress功能（可按类别筛选）
• wordpress_get_ability -获取能力的完整细节，包括输入/输出模式
• wordpress_execute_ability -执行任何功能（GET表示只读，POST表示操作）
• wordpress_list_ability_categories -列出能力类别
• wordpress_get_ability_category -获取类别详细信息

WordPress能力API

服务器包括用于 WordPress能力API （噪音6.9+）。这些工具是 面向未来 --任何注册功能的插件都将通过此MCP服务器自动发现和执行。

BuddyPress能力mu插件

附带的mu插件包含在 extras/mu-plugins/buddypress-abilities.php 注册了8个BuddyPress特定能力：

要安装： 将文件复制到您的WordPress网站 wp-content/mu-plugins/ 目录：

cp extras/mu-plugins/buddypress-abilities.php /path/to/wordpress/wp-content/mu-plugins/

需要WordPress 6.9+和BuddyPress。无需配置——能力会自动注册。

示例用法

配置后，您可以要求Claude与您的BuddyPress网站进行交互：

"Show me the latest 10 activities on my BuddyPress site"

"Create a new activity post with the content 'Hello from MCP!'"

"List all groups and show me their member counts"

"Get the profile data for user ID 5"

"Send a message to users 3 and 4 with subject 'Meeting' and content 'Let's meet tomorrow'"

"Show me all unread notifications for user 2"

"List all available WordPress abilities"

"Execute the buddypress/community-stats ability"

"Search for members named John using the abilities API"

发展

构建

npm run build

观看模式

npm run watch

跑

npm start

安全说明

1. 应用程序密码： 始终使用WordPress应用程序密码而不是主密码
2. HTTPS： 在生产环境中使用HTTPS
3. 权限： 确保经过身份验证的用户具有适当的权限
4. 环境变量： 从不将凭据提交到版本控制

API 参考

此MCP服务器使用BuddyPress REST API v2。有关API的详细文档，请访问：

• BuddyPress REST API文档

故障排除

身份验证错误

• 验证您的应用程序密码是否正确
• 检查用户是否具有必要的权限
• 确保BuddyPress REST API可访问

连接错误

• 验证BUDDYPRESS_URL是否正确
• 检查网站是否可访问
• 确保没有防火墙或安全插件阻止API请求

未找到工具

• 配置更改后重新启动Claude Desktop
• 检查配置文件语法是否为有效的JSON
• 验证构建的JavaScript文件的路径是否正确

贡献

欢迎投稿！请随时提交问题或拉取请求。

许可证

MIT许可证

支持

对于问题和疑问：

• Buddy出版社：https://buddypress.org/support/
• MCP-SDK：https://github.com/anthropics/model-context-protocol

版本历史

2.1.0

• WordPress能力API集成（5个新工具）
• BuddyPress能力mu插件（8种能力）
• wordpress://abilities/registry 资源
• wordpressRequest() / wordpressPaginatedRequest() 客户端功能

2.0.0

• 模块化架构重构
• 42个新工具、资源和提示

1.0.0

• 初始版本
• 支持活动、成员、组、XProfile、朋友、消息、通知
• 主要端点的完整CRUD操作
• 全面的过滤和分页