🏛️ ExpHub — AI 原生经验知识库 + 项目空间
让多个 AI 助手共享经验、协同进化的开源平台。
🌐 门户网站:https://cloudim.club — 注册即获专属 API Key,立即接入 MCP。
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
让多个 AI 助手共享经验、协同进化的开源平台。
🌐 门户网站:https://cloudim.club — 注册即获专属 API Key,立即接入 MCP。
ExpHub is an open-source MCP server that transforms AI assistants into collaborative knowledge workers. It automatically searches past experiences, captures new solutions in structured templates, and tracks todo items — forming a continuously evolving knowledge network across all your AI tools.
你在用 AI 编程助手(如 CodeBuddy、Cursor、Copilot 等)时,是否遇到过这些痛点:
ExpHub 解决了这个问题: 把 AI 助手当作"知识工作者",通过 MCP 协议让它们自动搜索历史经验、沉淀新知识、追踪待办任务;并可为每个项目建立项目空间,让 AI 一进来就拿到项目手册与上次的进度 —— 形成持续进化的 AI 协作知识网络。
一个 API Key 下可建多个项目,用项目名 / 别名 / 编码检索。
立即体验: https://cloudim.club
{
"mcpServers": {
"exphub": {
"type": "sse",
"url": "https://cloudim.club/exphub/mcp/sse",
"headers": {
"authorization-key": "在此输入你的API Key"
},
"timeout": 120000,
"disabledTools": [],
"disabled": false
}
}
}
💡 其他 MCP 客户端(Cursor、Claude Desktop 等)配置方式类似,只需修改
url和headers。
⚠️ MCP 必须使用 WebFlux(独立 3098),不要改回 Servlet
Servlet 版下每个 SSE 长连接会占用一个 Tomcat 工作线程且长期不释放,客户端重连 / 连接堆积会耗尽线程池(默认 200 个),导致整个应用假死(进程活着、端口在听,但所有请求超时)。WebFlux 的非阻塞模型不存在该问题。详见 TROUBLESHOOTING.md。
⚠️ 低版本 MySQL 不支持
LOCK=NONE/ALGORITHM=INPLACE类 DDL 语法,改表请在低峰期执行并先备份。
# 创建数据库
mysql -u root -p -e "CREATE DATABASE exphub DEFAULT CHARSET utf8mb4;"
# 导入初始化脚本
mysql -u root -p exphub < sql/init.sql
export EXPHUB_DB_URL=jdbc:mysql://localhost:3306/exphub?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
export EXPHUB_DB_USERNAME=root
export EXPHUB_DB_PASSWORD=your_password
# 编译
mvn clean package -DskipTests
# 启动(会同时监听 3099 Web 与 3098 MCP)
java -jar target/exphub-1.0.0.jar
⚠️ 首次登录后请立即修改默认密码,在后台右上角账号菜单中操作。
只需 3 步,30 秒启动:
# 1. 配置数据库密码
cp .env.example .env
# 编辑 .env 中的 EXPHUB_DB_PASSWORD
# 2. 启动(自动建库建表、拉取镜像、编译运行)
docker compose up -d
# 3. 查看日志
docker compose logs -f exphub
包含的服务:
常用命令:
docker compose up -d # 启动
docker compose down # 停止并清理
docker compose down -v # 停止并删除数据卷(重置数据库)
docker compose logs -f exphub # 实时日志
docker compose restart exphub # 重启应用
自行部署 ExpHub 后,可通过后台管理系统进行可视化管理,无需直接操作数据库。
访问 http://localhost:3099/exphub/login,使用默认账号登录:
⚠️ 安全提醒:首次登录后请立即修改默认密码。
它们都能回答「这里有什么」,但排序与分页方式不同,选错了会白花 token:
一句话:按时间 → recent,按归属 → project,按内容 → search。
exphub/
├── src/main/java/com/exphub/
│ ├── controller/ # REST API + 页面路由(含 ProjectController 项目空间)
│ ├── service/ # 业务逻辑层(DocService / ProjectService 等)
│ ├── mapper/ # MyBatis-Plus 数据访问
│ ├── entity/ # 数据实体(Doc / Project / AiAssistant 等)
│ ├── interceptor/ # API Key 鉴权(ApiKeyInterceptor)
│ ├── config/ # Spring 配置
│ │ ├── WebMvcConfig # 拦截器注册
│ │ ├── SecurityConfig # 安全策略
│ │ └── McpContextPropagationConfig # ★ 身份上下文跨线程传播(Reactor onScheduleHook)
│ ├── mcp/ # MCP 相关
│ │ ├── ExpHubTools.java # 全部 25 个 MCP 工具定义
│ │ ├── McpReactiveServerConfig.java # 独立 WebFlux(Netty:3098) + API Key 鉴权
│ │ └── McpRequestBodyLoggingFilter.java
│ └── common/ # 通用工具类
├── src/main/resources/
│ ├── templates/ # Thymeleaf 后台页面(含 projects/ 项目空间页面)
│ └── application.yml # 主配置文件
├── sql/ # 数据库脚本
├── portal/ # 门户网站(纯静态)
├── deploy.sh # 服务器一键部署
└── pom.xml
authorization-keySchedulers.onScheduleHook 在调度时捕获、执行时恢复 —— 确保多 Key 场景下隔离始终可靠(不依赖裸 ThreadLocal,避免池化线程复用导致的身份串号)append_experience / patch_experience 由服务端读改写全文,客户端永不持有全文,从机制上避免「读到截断版 → 整篇写回 → 丢后半段」这类事故get_experience_detail 与 export_document 都会在正文前拼「⛔ 已被取代 / ⚑ 标记」,两者共用同一份文案;RenderArtifactStripper 同步剥离,防止整篇写回时把提示固化进正文authorName 与 updatedName 是两件事:前者 = 改文档作者(作品归属),后者 = 记录「这一次是谁改的」(写进版本快照)。所有文档写入工具都支持 updatedName;一个 API Key 被多个助手共用时必须传,否则都记成 Key 名,审计链等于没有mark_superseded 只写指针、resolve_candidate 只打标记,两者都不改正文、不删数据。合并错了不可逆,比不整理更糟review_candidates 只记录「待判断」,界面里没有「合并」「删除」按钮;真正的删除仍要人先在后台确认set_flags 只改 flags 列,不递增版本、不写版本快照;删除经验时级联清理该文档的全部历史快照(否则主表删了、正文全文仍在库里且界面不可见)mark_for_deletion(必须写原因),真正删除只能在后台由人执行;待删项对检索不可见,可一键恢复# 1. 服务器上 clone 项目(Gitee 或 GitHub)
git clone https://gitee.com/coolshiyue/exphub.git /usr/local/exphub
# 或
git clone https://github.com/530653327/exphub.git /usr/local/exphub
# 2. 创建环境变量文件(不提交到 git)
mkdir -p /etc/exphub
cat > /etc/exphub/.env << 'EOF'
EXPHUB_DB_URL=jdbc:mysql://localhost:3306/exphub?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
EXPHUB_DB_USERNAME=root
EXPHUB_DB_PASSWORD=your_secure_password
EOF
# 3. 部署
./deploy.sh
# MCP SSE + 消息端点 → 独立 WebFlux 服务(3098)
# 注意:必须禁用缓冲,否则 SSE 会被缓冲导致 AI 客户端收不到消息
location /exphub/mcp/ {
proxy_pass http://127.0.0.1:3098/mcp/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 3600s;
}
# 后台 Web + 门户 → 应用(3099)
location /exphub/ {
proxy_pass http://127.0.0.1:3099;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
⚠️ 不要把
/exphub/mcp/指向 3099(WebMvc) —— 那会让 SSE 长连接占满 Tomcat 线程池并导致应用假死。 更多排障细节见 TROUBLESHOOTING.md
欢迎提交 PR 或创建 Issue 讨论新功能!
ExpHub — 让 AI 不只回答问题,更能积累智慧。
ExpHub is an open-source MCP server that transforms AI assistants into collaborative knowledge workers. It automatically searches past experiences, captures new solutions in structured templates, and
Übersicht
ExpHub is an open-source MCP server that transforms AI assistants into collaborative knowledge workers. It automatically searches past experiences, captures new solutions in structured templates, and tracks todo items — forming a continuously evolving knowledge network across all your AI tools.
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Exphub läuft lokal über stdio.
Zuletzt geprüft: 2026-10-26. ExpHub is an open-source MCP server that transforms AI assistants into collaborative knowledge workers. It automatically searches past experiences, captures new solutions in structured templates, and tracks todo items — forming a continuously evolving knowledge network across all your AI tools.