Tribal MCP Server

MCP文档知识

提供方 agentience

文档知识 stdio · 本地进程 Token 社区 / 第三方 ClaudeCline
查看接入方式

Tribal是一个基于MCP协议的错误知识追踪与检索服务,提供REST API和原生MCP接口,帮助Claude等工具记录和检索编程错误及解决方案。

一句话选型结论

按资料字段整理

Tribal MCP Server 属于文档知识类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude、Cline,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 4 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

错误追踪Python本地部署知识管理编程辅助向量搜索RESTAPI

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -m build

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cline 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Tribal MCP Server当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方agentience上游标注的维护方 agentience
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.0 KB
来自项目仓库与上游目录的原文,未做删改

部落-知识服务

Tribal是一个用于错误知识跟踪和检索的MCP(模型上下文协议)服务器实现。它提供REST API和本地MCP接口,用于与Claude Code和Cline等工具集成。

特性

  • 存储和检索具有完整上下文的错误记录
  • 基于ChromaDB的矢量相似性搜索
  • REST API(FastAPI)和本机MCP接口
  • 使用API密钥的JWT身份验证
  • 本地存储(ChromaDB)和AWS集成
  • Docker组合部署
  • CLI客户端集成

概述

Tribal帮助Claude记住编程错误并从中学习。当您启动Claude Code会话时,Tribal将通过MCP自动可用,无需额外导入。

克劳德将:

  1. 存储编程错误和解决方案
  2. 遇到问题时搜索类似错误
  3. 构建一个专门针对您的编码模式的知识库

用紫外线包装和安装Tribal

先决条件

  • Python 3.12+
  • uv包管理器(推荐)

构建和安装步骤

选项1:直接安装紫外线

最简单的方法是直接从当前目录安装:```bash

From the project root directory

cd /path/to/tribal

Install using uv

uv pip install .


#### 选项2:开发安装

对于您希望立即反映更改的开发工作:```bash
# From the project root directory
cd /path/to/tribal

# Install in development mode
uv pip install -e .

选项3:先构建包

如果你想构建一个可分发的包:```bash

Make sure you're in the project root directory

cd /path/to/tribal

Install the build package if needed

uv pip install build

Build the package

python -m build

This creates distribution files in the dist/ directory

Now install the wheel file

uv pip install dist/tribal-0.1.0-py3-none-any.whl


#### 选项4:使用 `uv tool install` 命令

您还可以使用工具安装方法:```bash
# Install as a global tool
cd /path/to/tribal
uv tool install .

# Or install in development mode
uv tool install -e .

验证

安装后,验证工具是否正确安装:```bash

Check the installation

which tribal

Check the version

tribal version


### 与Claude整合

安装后,您可以与Claude集成:```bash
# Add Tribal to Claude Code
claude mcp add tribal --launch "tribal"

# Verify the configuration
claude mcp list

# For Docker container
claude mcp add tribal http://localhost:5000

用法

可用的MCP工具

Tribal提供以下MCP工具:

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

Claude使用示例

当Claude遇到错误时:```
I'll track this error and look for similar problems in our knowledge base.


当克劳德找到解决方案时:```
I've found a solution! I'll store this in our knowledge base for next time.

克劳德的命令

你可以要求克劳德:

  • “在我们的部落知识库中查找类似的错误”
  • “将此解决方案存储到我们的错误数据库”
  • “检查我们以前是否见过此错误”

运行服务器

使用部落命令```bash

Run the server

tribal

Get help

tribal help

Show version

tribal version

Run with options

tribal server --port 5000 --auto-port


#### 使用Python模块```bash
# Run the Tribal server
python -m mcp_server_tribal.mcp_app

# Run the FastAPI backend server
python -m mcp_server_tribal.app

使用传统入口点```bash

Legacy MCP server

mcp-server

Legacy FastAPI server

mcp-api


### 命令行选项```bash
# Development mode with auto-reload
mcp-api --reload
mcp-server --reload

# Custom port
mcp-api --port 8080
mcp-server --port 5000

# Auto port selection
mcp-api --auto-port
mcp-server --auto-port

FastAPI服务器将在http://localhost:8000API文档位于/docs。
MCP服务器将在http://localhost:5000适用于Claude和其他兼容MCP的LLM。

环境变量

FastAPI服务器

  • PERSIST_DIRECTORY:ChromaDB存储路径(默认:“./chroma_db”)
  • API_KEY:身份验证密钥(默认:“dev-api-key”)
  • SECRET_KEY:JWT签名密钥(默认:“生产中不安全的开发密钥更改”)
  • REQUIRE_AUTH:身份验证要求(默认值:“false”)
  • PORT:服务器端口(默认值:8000)

MCP服务器

  • MCP_API_URL:FastAPI服务器URL(默认值:“http://localhost:8000")
  • MCP_PORT:MCP服务器端口(默认值:5000)
  • MCP_HOST:要绑定的主机(默认值:“0.0.0.0”)
  • API_KEY:FastAPI访问密钥(默认:“dev-api密钥”)
  • AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_S3_BUCKET:用于AWS集成

API终点

  • POST /errors:创建新的错误记录
  • GET /errors/{error_id}:按ID获取错误
  • PUT /errors/{error_id}:更新错误记录
  • DELETE /errors/{error_id}:删除错误
  • GET /errors:按条件搜索错误
  • GET /errors/similar:查找类似错误
  • POST /token:获取身份验证令牌

使用客户端```bash

Add a new error record

mcp-client --action add --error-type ImportError --language python --error-message "No module named 'requests'" --solution-description "Install requests" --solution-explanation "You need to install the requests package"

Get an error by ID

mcp-client --action get --id

Search for errors

mcp-client --action search --error-type ImportError --language python

Find similar errors

mcp-client --action similar --query "ModuleNotFoundError: No module named 'pandas'"


### 运作原理

1. Tribal使用ChromaDB存储错误记录和解决方案
1. 当Claude遇到错误时,它会将错误详细信息发送给Tribal
1. 部落将错误矢量化并搜索类似的错误
1. Claude收到相关解决方案并提出建议
1. 存储新的解决方案以供将来参考

## 发展

### 运行测试```bash
pytest
pytest tests/path_to_test.py::test_name  # For specific tests

过梁和类型检查```bash

ruff check .
mypy .
black .


### GitHub工作流

该项目使用GitHub Actions进行持续集成和部署。工作流会自动对push-to-main和pull请求运行测试、linting和类型检查。

#### 工作流程步骤

1. **测试**:运行linting、类型检查和单元测试

- 使用Python 3.12
- 使用uv安装依赖项
- 运行ruff,黑色,mypy和pytest

1. **构建和发布**:构建包并将其发布到PyPI

- 仅在向主分支推送时触发
- 使用Python的构建系统
- 使用麻线发布到PyPI

#### 本地测试

您可以使用提供的脚本在本地测试GitHub工作流:```bash
# Make the script executable
chmod +x scripts/test-workflow.sh

# Run the workflow locally
./scripts/test-workflow.sh

此脚本模拟本地计算机上的GitHub工作流步骤:

  • 检查Python版本(推荐3.12)
  • 使用uv安装依赖项
  • 长着褶边
  • 用黑色检查格式
  • 使用mypy运行类型检查
  • 使用pytest运行测试
  • 构建包

注意:脚本跳过本地测试的发布步骤。

项目结构```

tribal/
├── src/
│ ├── mcp_server_tribal/ # Core package
│ │ ├── api/ # FastAPI endpoints
│ │ ├── cli/ # Command-line interface
│ │ ├── models/ # Pydantic models
│ │ ├── services/ # Service layer
│ │ │ ├── aws/ # AWS integrations
│ │ │ └── chroma_storage.py # ChromaDB implementation
│ │ └── utils/ # Utility functions
│ └── examples/ # Example usage code
├── tests/ # pytest test suite
├── docker-compose.yml # Docker production setup
├── pyproject.toml # Project configuration
├── VERSIONING.md # Versioning strategy documentation
├── CHANGELOG.md # Version history
├── .bumpversion.cfg # Version bumping configuration
└── README.md # Project documentation


## 版本控制

部落跟随 语义版本控制。参见 版本.md 有关以下内容的完整详细信息:

- 版本编号(主要、次要、补丁)
- 数据库兼容性的架构版本控制
- 分支命名约定
- 发布和修补程序

检查版本:```bash
# Display version information
tribal version

管理依赖关系```bash

Add a dependency

uv pip add

Add a development dependency

uv pip add

Update dependencies

uv pip sync requirements.txt requirements-dev.txt


## 部署

### Docker部署```bash
# Build and start containers
docker-compose up -d --build

# View logs
docker-compose logs -f

# Stop containers
docker-compose down

# With custom environment variables
API_PORT=8080 MCP_PORT=5000 REQUIRE_AUTH=true API_KEY=your-secret-key docker-start

Claude桌面集成

选项1:让Claude for Desktop启动服务器

  1. 打开 ~/Library/Application Support/Claude/claude_desktop_config.json

  2. 添加MCP服务器配置(假设已安装Tribal工具):```json
    {
    "mcpServers": [
    {
    "name": "tribal",
    "launchCommand": "tribal"
    }
    ]
    }


1. 重新启动桌面版的Claude

#### 选项2:连接到正在运行的Docker容器

1. 启动容器:```bash
cd /path/to/tribal
docker-start
  1. 为桌面配置Claude:```json
    {
    "mcpServers": [
    {
    "name": "tribal",
    "url": "http://localhost:5000"
    }
    ]
    }

### Claude代码CLI集成```bash
# For Docker container
claude mcp add tribal http://localhost:5000

# For directly launched server
claude mcp add tribal --launch "tribal"

# Test the connection
claude mcp list
claude mcp test tribal

故障排除

  1. 验证部落安装: which tribal
  2. 检查配置: claude mcp list
  3. 测试服务器状态: tribal status
  4. 在Claude输出中查找错误消息
  5. 检查数据库目录是否存在以及是否具有适当的权限

云部署

该项目包括AWS服务的占位符实现:

  • S3Storage:用于在Amazon S3中存储错误记录
  • DynamoDBStorage:用于使用DynamoDB作为数据库

许可证

MIT许可证

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Tribal MCP Server 怎么安装?

在客户端按下面的安装命令接入:python -m build。装完在客户端配置里引用同一个包或端点。

Tribal MCP Server 怎么在 Claude、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Tribal MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Tribal MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Tribal MCP Server 支持哪些客户端?

资料标注支持 Claude、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Tribal MCP Server 能提供哪些能力?

资料显示能力标签包括 编程辅助、Python、Claude、向量搜索。具体工具清单以官方文档为准。

Tribal MCP Server 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Tribal MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。