Flarum Post MCP

Flarum MCP 服务器

🚀 为Flarum论坛设计的模型上下文协议（MCP）服务器，使AI助手能够直接在Flarum上发帖

  

中文文档 | 英文

✨ 特点/功能

• 🤖 表示机器人或机器人的形象。 AI自动发帖通过人工智能助手（如Claude、AiPy等）自动生成并发布论坛帖子
• 🔐 灵活认证支持用户名/密码自动登录或直接API令牌配置
• 🏷️（标签） 智能标签AI自动分析内容并匹配最合适的标签
• 📊（表格） 标签控制可配置的标签数量范围和默认标签
• 📝 智能内容生成内置内容规范，用于生成自然、对话式的帖子
• ⚡（闪电符号，无具体含义，常用于表示快速、能量或电力等概念） 高性能令牌缓存，标签缓存，性能优化

📋 要求

• Python 3.10 或更高版本
• Flarum论坛账号
• 兼容MCP的人工智能客户端（如Claude Desktop、AiPy等）

🚀 快速入门

1️⃣ 克隆项目

git clone https://github.com/wszdb/FlarumPost-MCP.git
cd FlarumPost-MCP

2️⃣ 安装依赖项

pip install requests mcp

3️⃣ 配置MCP服务器

在您的MCP客户端配置文件中添加以下内容：

方法1：Claude桌面配置

{
  "mcpServers": {
    "Flarum": {
      "command": "python",
      "args": ["/path/to/FlarumPost-MCP/server.py"],
      "env": {
        "FLARUM_URL": "https://your-forum.com",
        "FLARUM_USERNAME": "your_username",
        "FLARUM_PASSWORD": "your_password",
        "FLARUM_MIN_TAGS": "1",
        "FLARUM_MAX_TAGS": "3",
        "FLARUM_DEFAULT_TAGS": "general,discussion"
      }
    }
  }
}

方法2：AiPy Pro配置示例

1. Name: Flarum MCP
2. Type: studio
3. Command: python
4. Arguments: E:\code\FlarumPost-MCP\server.py
5. Environment Variables:
FLARUM_URL=https://bbs.a.com
FLARUM_USERNAME=admin
FLARUM_PASSWORD=password
FLARUM_MIN_TAGS=2
FLARUM_MAX_TAGS=2

4️⃣ 重启客户端

重启 Claude Desktop 或 AiPy 以加载服务器。

📖 使用方法

基本用法

只需向您的AI助手发送指令：

Help me post on the forum, title "Beautiful Weather Today", talk about the weather

AI将自动：

1. 根据规范生成内容（≤250字，口语化）
2. 分析内容主题并选择合适的标签
3. 打电话给 create_discussion 工具
4. 返回帖子结果（帖子ID、链接等）

高级用法

Post something, title "Weekend Plans", talk about weekend travel plans, about 500 words

人工智能将会：

• 根据关键词（如“周末、旅行”（例如，旅行、休闲））匹配标签
• 生成约500字的对话内容
• 自动发布

专家使用

Automatically fetch materials from web search and auto-post

⚙️ 环境变量

注释：

• 🔄 二选一：必须配置 USERNAME + PASSWORD 或者 API_TOKEN
• ❌ 可选配置

🎯 应用场景

案例1：AI自动选择标签（推荐）

配置：

{
  "FLARUM_URL": "https://forum.example.com",
  "FLARUM_USERNAME": "admin",
  "FLARUM_PASSWORD": "password123",
  "FLARUM_MIN_TAGS": "2",
  "FLARUM_MAX_TAGS": "4"
}

效果： AI根据帖子内容选择2-4个最合适的标签

案例2：固定标签发布

配置：

{
  "FLARUM_URL": "https://forum.example.com",
  "FLARUM_USERNAME": "admin",
  "FLARUM_PASSWORD": "password123",
  "FLARUM_DEFAULT_TAGS": "announcement,important"
}

效果： 所有帖子均使用“公告”和“重要”标签，非常适合批量发布公告

🔧 工作原理

认证流程

Start Server
    ↓
Check Configuration
    ↓
Has API_TOKEN?
    ↓ Yes              ↓ No
Use Token       Call /api/token to get Token
    ↓                   ↓
    └─────→ Cache Token ←┘
            ↓
    Use Token for Posting
            ↓
        401 Error?
            ↓ Yes
    Clear Cache, Re-get Token

标签匹配流程

Start Server
    ↓
Fetch All Forum Tags
    ↓
Cache in Memory
    ↓
Display Tag List in Tool Description
    ↓
User Initiates Post Request
    ↓
Default Tags Configured?
    ↓ Yes              ↓ No
Use Default Tags   AI Views Tag List & Selects
    ↓                   ↓
    └─────→ Validate Tags ←┘
            ↓
        Publish Post

🐛 故障排除

问题1：令牌检索失败

错误： ❌ Token retrieval failed (401)

解决方案：

• 检查用户名/密码是否正确
• 确认账户具有记账权限
• 验证论坛支持情况 /api/token 终端节点

问题2：标签未找到

错误： ❌ Error: Tag 'xxx' not found

解决方案：

• 检查标签别名的拼写（区分大小写）
• 确认标签存在于论坛管理员中
• 重启MCP服务器以刷新标签缓存

问题3：令牌已过期

信息： ⚠️ Token expired, re-getting...

注： 程序自动重新获取令牌，无需手动操作

📊 技术特性

• ✅ 自动代币管理用户名/密码自动获取令牌，过期时自动刷新
• ✅ 标签缓存启动时获取标签列表并进行缓存，避免重复请求
• ✅ 智能匹配AI根据内容选择最合适的标签
• ✅ 灵活配置支持标签数量范围和默认值
• ✅ 向后兼容完全兼容旧版API令牌配置
• ✅ 错误处理全面的异常处理和重试机制

🤝 贡献/参与

欢迎提出问题和提交拉取请求！

📄 许可证

麻省理工学院许可证

🙏 致谢

感谢所有使用和支持这个项目的用户！

______________________________________________________________________

项目网址： https://github.com/wszdb/FlarumPost-MCP 翻译为中文是：“https://github.com/wszdb/FlarumPost-MCP（GitHub仓库链接，指向w_szdb用户或组织的FlarumPost-MCP项目）”。不过，通常在中文语境下，我们不会直接翻译网址，而是直接提供网址或简要说明其内容，如“这是GitHub上的一个FlarumPost-MCP项目链接”。如果非要翻译整个网址（尽管这不是常见做法），上述翻译即为一种可能的形式

问题报告： 请在GitHub上提交问题