Tribal - Knowledge Service

基本能力

产品定位

Tribal是一个错误知识跟踪和检索的MCP服务器实现，旨在帮助AI助手（如Claude）记忆和学习编程错误，构建特定于用户编码模式的知识库。

核心功能

• 存储和检索带有完整上下文的错误记录
• 使用ChromaDB进行向量相似性搜索
• 提供REST API（FastAPI）和原生MCP接口
• 支持JWT认证和API密钥
• 本地存储（ChromaDB）和AWS集成
• Docker-compose部署
• CLI客户端集成

适用场景

• AI编程助手错误记忆和学习
• 编程错误解决方案知识库构建
• 代码调试辅助工具
• 开发团队知识共享

工具列表

1. add_error - 创建新错误记录
2. get_error - 通过UUID检索错误
3. update_error - 修改现有错误
4. delete_error - 删除错误记录
5. search_errors - 按条件搜索错误
6. find_similar - 语义相似性搜索
7. get_token - 获取JWT令牌

常见问题解答

1. 验证Tribal安装: which tribal
2. 检查配置: claude mcp list
3. 测试服务器状态: tribal status
4. 检查数据库目录权限

使用教程

使用依赖

• Python 3.12+
• uv包管理器（推荐）

安装教程

直接安装

cd /path/to/tribal
uv pip install .

开发模式安装

cd /path/to/tribal
uv pip install -e .

构建包后安装

cd /path/to/tribal
uv pip install build
python -m build
uv pip install dist/tribal-0.1.0-py3-none-any.whl

工具安装

cd /path/to/tribal
uv tool install .

调试方式

# 验证安装
which tribal

# 检查版本
tribal version

# 运行服务器
tribal

# 获取帮助
tribal help

# 自定义端口运行
tribal server --port 5000 --auto-port

与Claude集成

# 添加Tribal到Claude Code
claude mcp add tribal --launch "tribal"

# 验证配置
claude mcp list

# 连接Docker容器
claude mcp add tribal http://localhost:5000

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。