基本能力
产品定位
Tribal是一个错误知识跟踪和检索的MCP服务器实现,旨在帮助AI助手(如Claude)记忆和学习编程错误,构建特定于用户编码模式的知识库。
核心功能
- 存储和检索带有完整上下文的错误记录
- 使用ChromaDB进行向量相似性搜索
- 提供REST API(FastAPI)和原生MCP接口
- 支持JWT认证和API密钥
- 本地存储(ChromaDB)和AWS集成
- Docker-compose部署
- CLI客户端集成
适用场景
- AI编程助手错误记忆和学习
- 编程错误解决方案知识库构建
- 代码调试辅助工具
- 开发团队知识共享
工具列表
add_error
- 创建新错误记录get_error
- 通过UUID检索错误update_error
- 修改现有错误delete_error
- 删除错误记录search_errors
- 按条件搜索错误find_similar
- 语义相似性搜索get_token
- 获取JWT令牌
常见问题解答
- 验证Tribal安装:
which tribal
- 检查配置:
claude mcp list
- 测试服务器状态:
tribal status
- 检查数据库目录权限
使用教程
使用依赖
- Python 3.12+
- uv包管理器(推荐)
安装教程
直接安装
bash
cd /path/to/tribal
uv pip install .
开发模式安装
bash
cd /path/to/tribal
uv pip install -e .
构建包后安装
bash
cd /path/to/tribal
uv pip install build
python -m build
uv pip install dist/tribal-0.1.0-py3-none-any.whl
工具安装
bash
cd /path/to/tribal
uv tool install .
调试方式
```bash
验证安装
which tribal
检查版本
tribal version
运行服务器
tribal
获取帮助
tribal help
自定义端口运行
tribal server --port 5000 --auto-port
```
与Claude集成
```bash
添加Tribal到Claude Code
claude mcp add tribal --launch "tribal"
验证配置
claude mcp list
连接Docker容器
claude mcp add tribal http://localhost:5000
```