Tribal - Knowledge Service

基本能力

产品定位

Tribal 是一个知识服务服务器，专注于错误知识的跟踪和检索，帮助开发者通过存储和检索错误记录来提高开发效率。

核心功能

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

适用场景

• 开发过程中遇到的编程错误记录与检索
• 自动搜索类似错误并提供解决方案
• 构建个人或团队的编程错误知识库

工具列表

1. add_error - 创建新的错误记录 (POST /errors)
2. get_error - 通过 UUID 检索错误 (GET /errors/{id})
3. update_error - 修改现有错误 (PUT /errors/{id})
4. delete_error - 删除错误记录 (DELETE /errors/{id})
5. search_errors - 通过条件查找错误 (GET /errors)
6. find_similar - 语义相似性搜索 (GET /errors/similar)
7. get_token - 获取 JWT 令牌 (POST /token)

常见问题解答

1. 如何验证 Tribal 安装？使用 which tribal 命令。
2. 如何检查服务器状态？使用 tribal status 命令。
3. 如何测试服务器连接？使用 claude mcp test tribal 命令。

使用教程

使用依赖

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

安装教程

选项1：直接安装

cd /path/to/tribal
uv pip install .

选项2：开发模式安装

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

选项3：先构建包

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

选项4：使用 uv tool install 命令

cd /path/to/tribal
uv tool install .

调试方式

# 验证安装
which tribal

# 检查版本
tribal version

# 运行服务器
tribal

# 获取帮助
tribal help

许可证

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