Tribal について
Tribal はソフトウェア開発向けの個人用ナレッジコンテキストエンジンで、開発知見を検索するコーディングエージェントを対象としています。デバッグの学び、経験則、判断の根拠を記録し、MCP 経由で取得できるようにします。
主な機能
- 01開発の学びとデバッグ知見を記録
- 02経験則と判断の根拠を保存
- 03コーディングエージェントによる知識検索
- 04stdio で MCP サーバーを実行
活用シーン
- 01技術的な判断の背景を振り返る
- 02新たな問題で過去のデバッグ知見を探す
- 03開発に役立つ経験則を検索
MCP 対応
stdio トランスポートの MCP サーバーを通じて、記録した開発知識をコーディングエージェントが検索できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
mcp.json · 共通設定
起動コマンド
docker run -i --rm -e TRIBAL_DATABASE__URL -e TRIBAL_PROJECT_REMOTE -e TRIBAL_PROJECT_NAME -e TRIBAL_SERVER__TRANSPORT -e TRIBAL_SERVER__BIND_ADDRESS -e TRIBAL_PUBLIC_MCP_URL -e OPENAI_API_KEY -e ANTHROPIC_API_KEY ghcr.io/tribal-memory/tribal:0.4.1設定が必要な環境変数
TRIBAL_DATABASE__URLPostgres (pgvector) connection string. Tribal is self-hosted; you provide the database. The supported, complete deployment is docker-compose.yml.TRIBAL_PROJECT_REMOTEFirst-run only: the git remote that identifies the project bootstrapped on first start.TRIBAL_PROJECT_NAMEFirst-run only: the name of the project bootstrapped on first start.TRIBAL_SERVER__TRANSPORTContainerised transport: http or sse. The Docker image does not serve stdio; install the binary for stdio.TRIBAL_SERVER__BIND_ADDRESSAddress the server binds inside the container. Must be 0.0.0.0 (not the loopback default) for the published port to be reachable.TRIBAL_PUBLIC_MCP_URLThe URL clients use to reach the server (for example http://127.0.0.1:8725/mcp). Needed for OAuth dynamic client registration once the server binds a routable interface.OPENAI_API_KEYシークレットOptional; only if an ingest or retrieval stage is configured to use OpenAI (defaults target a local Ollama).ANTHROPIC_API_KEYシークレットOptional; only if a stage is configured to use Anthropic.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
パッケージ
oci
ghcr.io/tribal-memory/tribal:0.4.1Streamable HTTPツール
ツール一覧はまだ取得されていません
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Tribal
ソフトウェア開発向けの個人用ナレッジコンテキストエンジンです。Tribal は、開発作業から得た学び、デバッグの知見、ヒューリスティック、意思決定の根拠を記録し、MCP(Model Context Protocol)を介してコーディングエージェントがその知識を検索できるようにします。
前提条件
- Rust(安定版ツールチェーン、1.89 以降)
- Rust nightly(rustfmt 用 —
rustup toolchain install nightly) - Docker(ローカルの Postgres とテストコンテナ用)
- just —
cargo install just - sqlx-cli —
cargo install sqlx-cli --no-default-features --features postgres - cargo-deny —
cargo install cargo-deny
セットアップ
git clone [email protected]:samfolo/tribal.git
cd tribal
just db-up
just db-migrate
just check
just test
実行
# Run the MCP server (stdio transport)
just serve
# Run with a specific project
just serve-project <project_id>
開発
# Format code (requires nightly rustfmt)
just fmt
# Lint and format check
just check
# Run all tests
just test
# Run unit tests only (no database required)
just test-unit
# Full pre-push check (format, lint, test)
just pre-push
# Regenerate sqlx offline query metadata
just sqlx-prepare
ライセンス
MIT
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。