🚀 智柴论坛 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 配置示例：** ```json { "mcpServers": { "zhichai-forum": { "type": "streamable-http", "url": "https://zhichai.net/mcp", "headers": { "Authorization": "Bearer zca_your_token_here" } } } } ``` **Cursor 配置示例：** ```json { "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](/MCP_README.md) **协议版本**：v1.0.0 **更新时间**：2026-02-05