Tribal MCP Server

🚀 部落 - 族裔ツールドキュメント

部落（Tribal）は、人類学者や研究者向けに設計された、異文化データの分析と管理を行うためのツールです。強力なデータ処理、可視化、協調機能を備え、異なる文化背景における社会構造と相互作用パターンを深く理解するのに役立ちます。

🚀 クイックスタート

プロジェクトの初期化

tribal init my_project
cd my_project

サービスの起動

tribal start

CLIの使用

tribal --help

✨ 主な機能

• データのインポートとエクスポート：複数の形式のデータのインポートとエクスポートをサポートします。
• データ分析：高度なデータ分析ツールを提供し、文化パターンや傾向を特定するのに役立ちます。
• 可視化：様々なグラフや地図が組み込まれており、データを直感的に表示します。
• 協調機能：チームメンバーがリアルタイムで協力し、研究成果を共有できます。

📦 インストール

pipを使用したインストール

pip install tribal

ソースコードからのインストール

1. リポジトリをクローンします：

   git clone https://github.com/tribal-project/Tribal.git
   cd Tribal
   

2. 依存関係をインストールします：

   uv pip sync requirements.txt requirements-dev.txt
   

3. プロジェクトをインストールします：

   python -m pip install -e .
   

💻 使用例

データのインポート

tribal import data.csv --format csv

データの分析

tribal analyze --group-id 123

結果の可視化

tribal visualize --analysis-id 456

📚 ドキュメント

データモデル

部落は、文化と社会構造を記述するためにカスタムデータモデルを使用しています。核心的なモデルには以下のものがあります：

• CulturalGroup：文化グループを表します。
• SocialNetwork：社会ネットワーク関係を表します。
• CustomData：カスタムデータを保存するために使用されます。

APIドキュメント

すべての文化グループを取得する

tribal api list-groups

新しい文化グループを作成する

tribal api create-group --name "My New Group"

文化グループを削除する

tribal api delete-group --group-id 123

🔧 高度な機能

Dockerによるデプロイ

コンテナの起動

docker-compose up -d --build

コンテナの停止

docker-compose down

Claudeとの統合

方法1：サーバーを直接起動する

1. 設定ファイルを変更します：

   {
     "mcpServers": [
       {
         "name": "tribal",
         "launchCommand": "tribal"
       }
     ]
   }
   

2. Claude for Desktopを再起動します。

方法2：実行中のコンテナに接続する

1. コンテナを起動します：

   cd /path/to/tribal
   docker-start
   

2. Claudeを設定します：

   {
     "mcpServers": [
       {
         "name": "tribal",
         "url": "http://localhost:5000"
       }
     ]
   }
   

問題のトラブルシューティング

1. 部落がインストールされていることを確認します：which tribal
2. 設定を確認します：claude mcp list
3. サーバーの状態をテストします：tribal status
4. エラーメッセージを確認します
5. データベースディレクトリが存在し、権限が正しいことを確認します

クラウドデプロイ

このプロジェクトは、AWSサービスを使用したプレースホルダ実装を提供しています：

• S3Storage：Amazon S3上にエラー記録を保存するために使用されます。
• DynamoDBStorage：DynamoDBをデータベースとして使用するために使用されます。

📄 ライセンス

MIT License