Tpc Server

🚀 🧩 TPC サーバー ✨

TPC サーバーは、AI エージェントまたは協働プロジェクトにおける推論過程、意図行動、実行手順を記録、保存、検索するためのバックエンドサービスを提供します。このサーバーは、FastAPI、MCP-Server、SQLAlchemy を使用して構築されています。

🤔 TPC とは何ですか？

核心的な考え方は、構造化された相互関連のあるログを作成することです。

• **思考（🧠）：**洞察、アイデア、観察結果、考慮事項、または行動前のデータポイントを記録します。
• **計画（📝）：**通常、思考過程から生まれる、意図的に取る行動、戦略、目標、または方法を定義します。
• **変更（✅）：**通常、特定の計画に関連付けられた、実際に実行された操作または変更を記録します。

このサーバーは、これらの項目とその関係（思考 <-> 計画 -> 変更）を記録するのに役立ちます。

✨ 主な機能

• **🧠 思考の追跡、📝 計画の策定、✅ 変更の記録：**各概念に専用のモデルと保存機能を提供します。
• **🔗 相互関連するデータ：**思考と計画（多対多）、特定の計画に対する実行手順としての変更（多対一）を関連付けます。
• **🌐 ウェブインターフェイス：**最近の活動、思考、計画、変更記録を閲覧するためのシンプルな HTML ビューを提供します。
• **🔌 JSON API：**プログラムによるデータ検索（最近の活動、すべての思考/計画/変更）のためのエンドポイントを提供します。
• 🤖 エージェントツール（MCP）：mcp-server を通じて、AI エージェントが TPC ストレージとやり取りできる関数（add_thought、create_plan、log_change、get_...）を提供します。
• **💾 データベースバックエンド：**SQLAlchemy を使用し、デフォルトでは SQLite を使用し、URL を通じて他のデータベースに簡単に設定できます。
• ⚙️ 設定可能：.env ファイルを通じて、DB URL、ホスト、ポート、エージェント通信の伝送方法（SSE/stdio）を設定できます。
• **🪄 自動テーブル作成：**初回実行時に、データベーステーブルが存在しない場合は自動的に作成します。

📦 インストール

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

   git clone [https://github.com/suttonwilliamd/tpc-server.git](https://github.com/suttonwilliamd/tpc-server.git)
   cd tpc-server
   

2. 仮想環境を作成してアクティブ化する：

   # 環境を作成する
   python -m venv venv
   
   # アクティブ化（macOS/Linux）
   source venv/bin/activate
   
   # アクティブ化（Windows - Git Bash/WSL）
   source venv/Scripts/activate
   
   # アクティブ化（Windows - Command Prompt/PowerShell）
   .\venv\Scripts\activate
   

3. 依存関係をインストールする：

   pip install -r requirements.txt
   

4. 環境を設定する： プロジェクトのルートディレクトリに .env ファイルを作成します。

   DATABASE_URL=sqlite:///tpc_server.db
   

5. サーバーを起動する：

   python main.py
   

📚 データベース

• デフォルトでは、プロジェクトディレクトリ内の SQLite ファイル（tpc_server.db）を使用します。これは簡単で、別のデータベースサーバーを必要としません。
• .env 内の DATABASE_URL を変更し、対応するドライバーをインストールすることで（例：pip install psycopg2-binary）、PostgreSQL、MySQL などの他のデータベースに簡単に切り替えることができます。
• テーブルは、起動時に SQLAlchemy によって自動的に作成されます（存在しない場合）。

🙌 コントリビューション

コントリビューション、問題の報告、機能リクエストを歓迎します！issues page をご覧になるか、pull request を送信してください。