tpc-server

✨ TPC サーバー ✨

エージェント（またはプロジェクト）の考え🧠、計画📝、変更✅を追跡しましょう！

TPCサーバーは、AIエージェントまたは共同プロジェクトの推論プロセス、意図されたアクション、実行されたステップを記録、保存、取得するためのバックエンドサービスを提供します。FastAPI、MCPサーバー、SQLAlchemyを使用して構築されています。

🤔 TPC とは何ですか?

中心となるアイデアは、構造化された相互接続されたログを作成することです。

• **思考 (🧠):**行動を決定する前に、洞察、アイデア、観察、考慮事項、または生のデータ ポイントを記録します。
• **計画 (📝):**多くの場合、思考から導き出された、意図した行動方針、戦略、目標、またはアプローチを定義します。
• **変更 (✅):**実行された具体的なアクションや行われた変更を記録します。通常、実行に役立つ特定の計画にリンクされます。

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

🚀 機能

• **🧠 考え、📝 計画、✅ 変更を追跡:**各コンセプト専用のモデルとストレージ。
• **🔗 相互接続されたデータ:**考えを計画にリンクし (多対多)、変更を計画にリンクします (多対 1)。
• **🌐 Web インターフェース:**最近のアクティビティ、考え、計画、変更を参照するためのシンプルな HTML ビュー。
• **🔌 JSON API:**プログラムによるデータ取得用のエンドポイント (最近の項目、すべての考え/計画/変更)。
• 🤖 エージェント ツール (MCP): AI エージェントが TPC ストアと対話するための関数をmcp-server経由で公開します ( 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. 仮想環境の作成とアクティブ化:
   # Create environment python -m venv venv # Activate (macOS/Linux) source venv/bin/activate # Activate (Windows - Git Bash/WSL) source venv/Scripts/activate # Activate (Windows - Command Prompt/PowerShell) .\venv\Scripts\activate
3. 依存関係をインストールします:
   Install using: ```bash pip install -r requirements.txt
4. **環境の設定:**プロジェクト ルートに.envファイルを作成します。
   # .env file # --- Database --- # Default: SQLite in project root. Use postgresql://user:pass@host:port/db for PostgreSQL, etc. DATABASE_URL="sqlite:///./tpc_server.db" # --- Server Network --- HOST="0.0.0.0" # Listen on all network interfaces PORT="8050" # Port for FastAPI and MCP SSE # --- Agent Communication --- # 'sse' (Server-Sent Events over HTTP) or 'stdio' (Standard Input/Output) TRANSPORT="sse"

▶️ サーバーの実行

仮想環境がアクティブであり、プロジェクト ルートにいることを確認します。

サーバーが起動し、Uvicorn（FastAPI用）とMCPサーバーのログが表示されます。設定されたHOSTとPORTでサーバーが動作していることを示す出力が表示されるはずです。

💡 使用方法

🖥️ ウェブインターフェース

ブラウザからシンプルな Web UI にアクセスします (デフォルト: http://localhost:8050 ):

• / : 最新の 10 件のアクティビティの概要。
• /thoughts : 記録されたすべての考えを一覧表示します。
• /plans : 記録されたすべてのプランを一覧表示します。
• /changes : 記録されたすべての変更を（関連するプランのタイトルとともに）一覧表示します。

💻 JSON API

プログラムでデータを取得する:

• GET /api/recent-activity : 最新の 10 件の考え、計画、変更を組み合わせたリスト。
• GET /api/thoughts : すべての考えのリスト。
• GET /api/plans : すべてのプランのリスト。
• GET /api/changes : すべての変更のリスト ( plan_titleを含む)。

🤖 エージェントツール（MCP経由）

AI エージェントは、設定されたTRANSPORTを使用して MCP サーバーに接続し、次のツールを使用します。

• add_thought(...) : 新しい考えを記録します。
• create_plan(...) : 新しいプランを定義します。
• log_change(...) : プランに対して実行されたアクションをログに記録します。
• get_recent_thoughts(...) : 最新の考えを取得します。
• get_active_plans() : すべての「アクティブ」なプランを取得します。
• get_changes_by_plan(...) : 特定のプラン ID の変更を取得します。
• get_thought_details(...) : 特定の思考 ID (リンクされた計画を含む) の詳細を取得します。
• get_plan_details(...) : 特定のプラン ID の詳細を取得します (リンクされた考えや変更を含む)。

(ツールの引数と使用方法に関する詳細なエージェントの手順については、 LLM.txtを参照してください。)

🗄️ データベース

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

🙌 貢献

貢献、問題、機能リクエストを歓迎します。問題ページをご確認いただくか、プルリクエストを送信してください。