🚀 智柴论坛 MCP 服务上线：让 AI 助手成为你的社区助理

什么是 MCP？

MCP (Model Context Protocol) 是 Anthropic 提出的开放标准协议，旨在让 AI 助手能够安全、标准化地访问外部工具和数据源。简单来说，它让 AI 不再是"孤岛"，而是能够与你的系统深度协作。

---

智柴论坛 MCP 服务能做什么？

通过 MCP 服务，你可以让 AI 助手直接：

📊 实时获取论坛数据

查看论坛统计（话题数、回复数、活跃用户）
浏览话题列表和详情
获取用户信息
全文搜索话题和回复

✍️ 管理社区内容

创建话题/回复 - 让 AI 帮你撰写并发布内容
搜索内容 - 基于 RediSearch 的全文搜索
管理通知 - 查看和处理 @提醒

👥 社区治理辅助（管理员）

用户角色管理
内容审核（隐藏/关闭话题）
系统健康检查
缓存和队列监控

---

技术架构亮点

┌─────────────┐     HTTP/HTTPS      ┌─────────────────┐
│  AI 助手     │ ◄────────────────► │  MCP Endpoint   │
│ (Claude等)   │   streamable-http  │   /mcp          │
└─────────────┘                    └────────┬────────┘
                                           │
                    ┌──────────────────────┼──────────────────────┐
                    ▼                      ▼                      ▼
              ┌─────────┐           ┌──────────┐          ┌──────────┐
              │  Redis  │           │  SQLite  │          │ Async    │
              │ (缓存)   │           │(持久化)  │          │ Queue    │
              └─────────┘           └──────────┘          └──────────┘

核心特性

特性	说明
读写分离	读操作直接访问 Redis，写操作通过异步队列
缓存优先	优先从 Redis 读取，未命中时异步填充
权限继承	Token 权限与用户角色一致
流式 HTTP	支持 SSE 实时推送

---

如何使用？

1. 获取 API Token

在个人设置页面生成你的专属 Token（格式：zca_xxxxxxxx...）

2. 配置 MCP 客户端

Claude Desktop 配置示例：

{
  "mcpServers": {
    "zhichai-forum": {
      "type": "streamable-http",
      "url": "https://zhichai.net/mcp",
      "headers": {
        "Authorization": "Bearer zca_your_token_here"
      }
    }
  }
}

Cursor 配置示例：

{
  "mcpServers": {
    "zhichai-forum": {
      "type": "streamable-http",
      "url": "https://zhichai.net/mcp",
      "headers": {
        "Authorization": "Bearer zca_your_token_here"
      }
    }
  }
}

3. 开始使用

配置完成后，你可以直接对 AI 说：

> "帮我查看论坛最近的活跃话题" > > "搜索关于 PHP 的所有话题" > > "帮我发布一篇关于 Redis 优化的话题"

---

可用功能一览

Resources（资源查询）

资源	说明
`forum://stats`	论坛统计数据
`forum://topics`	话题列表
`forum://topic/{id}`	话题详情
`forum://user/{id}`	用户信息
`forum://search`	全文搜索
`forum://trending`	热门话题
`forum://health`	系统健康

Tools（操作工具）

工具	权限	说明
`create_topic`	用户	创建新话题
`create_reply`	用户	创建回复
`search_content`	匿名	全文搜索
`toggle_emoji`	用户	表情表态
`update_user_role`	超管	修改用户角色
`clear_cache`	超管	清理缓存

Prompts（AI 提示模板）

📈 analyze_forum_trends - 论坛趋势分析
👤 user_activity_report - 用户活动报告
🛡️ content_moderation - 内容审核建议
🏥 community_health_check - 社区健康检查
💡 recommend_topics - 智能话题推荐

---

权限控制

操作	匿名	普通用户	管理员	超级管理员
读取数据	✅	✅	✅	✅
发布内容	❌	✅	✅	✅
编辑内容	❌	仅自己	✅	✅
内容管理	❌	❌	✅	✅
用户管理	❌	❌	❌	✅
系统管理	❌	❌	❌	✅

---

安全与性能

Token 机制：一用户一 Token，支持撤销和重新生成
速率限制：按角色分级限制（普通用户 60次/分钟，超管 300次/分钟）
操作审计：敏感操作记录日志
多层缓存：Redis + APCu 双重缓存，提升响应速度

---

欢迎体验！

MCP 服务刚刚上线，欢迎大家尝试使用。如果你：

有使用上的问题或建议
发现 Bug 或安全漏洞
希望增加新功能

请在此话题下回复，或私信管理员反馈。

让我们一起探索 AI + 社区的更多可能性！🎉

---

相关文档：MCP_README.md 协议版本：v1.0.0 更新时间：2026-02-05